异常：org.activiti.bpmn.exceptions.XMLException: 3 字节的 UTF-8 序列的字节 3 无效

这个错误表明 Maven 无法解析 `${activiti.version}` 占位符，通常是由于 **未正确定义 `activiti.version` 属性** 或 **依赖的版本号格式错误** 导致的。以下是解决方案： --- ### **1. 检查 `activiti.version` 是否正确定义** 在 `pom.xml` 的 `<properties>` 中必须显式声明 `activiti.version`，例如： ```xml <properties> <java.version>17</java.version> <activiti.version>7.1.0.M6</activiti.version> <!-- 确保版本号有效 --> </properties> ``` **常见错误**： - 忘记定义 `${activiti.version}`。 - 版本号拼写错误（如 `7.1.0.M4` 写成 `7.1.0-M4`）。 --- ### **2. 确认 Activiti 版本是否存在** 访问 [Maven Central](https://search.maven.org/) 搜索 `activiti-bpmn-model`，确认版本是否存在。例如： - **有效版本**：`7.1.0.M6`、`7.1.0.M4`（里程碑版）或 `6.0.0`（稳定版）。 - **无效版本**：`7.1.0`（可能不存在）或 `latest`（禁止使用动态版本）。 --- ### **3. 检查依赖作用域和传递性** 如果 `activiti-bpmn-model` 是其他依赖的传递依赖（如 `activiti-spring-boot-starter`），则无需直接声明。但若需显式引入，确保作用域正确： ```xml <dependency> <groupId>org.activiti</groupId> <artifactId>activiti-bpmn-model</artifactId> <version>${activiti.version}</version> <scope>compile</scope> <!-- 默认值，通常无需指定 --> </dependency> ``` --- ### **4. 清理 Maven 本地仓库** 如果本地仓库中的依赖损坏，删除残留文件后重新下载： ```bash rm -rf ~/.m2/repository/org/activiti/activiti-bpmn-model/ mvn clean install -U ``` --- ### **5. 检查父 POM 或 BOM 配置** 如果项目继承了父 POM 或使用 `<dependencyManagement>`，确保 `activiti.version` 未被覆盖： ```xml <dependencyManagement> <dependencies> <dependency> <groupId>org.activiti</groupId> <artifactId>activiti-dependencies</artifactId> <version>${activiti.version}</version> <type>pom</type> <scope>import</scope> </dependency> </dependencies> </dependencyManagement> ``` --- ### **6. 替代方案：直接指定版本** 如果问题持续，暂时放弃 `${activiti.version}` 占位符，直接写入版本号： ```xml <dependency> <groupId>org.activiti</groupId> <artifactId>activiti-bpmn-model</artifactId> <version>7.1.0.M6</version> <!-- 硬编码版本 --> </dependency> ``` --- ### **根本原因** - **属性未定义**：`${activiti.version}` 在 `<properties>` 中未声明。 - **版本号无效**：指定的 Activiti 版本在仓库中不存在。 - **仓库配置问题**：Maven 无法访问中央仓库或私有仓库。 --- ### **验证修复** 1. 运行以下命令检查依赖是否解析成功： ```bash mvn dependency:resolve | grep "activiti-bpmn-model" ``` 2. 确认输出中包含正确的版本号（如 `7.1.0.M6`）。 --- ### **扩展建议** - **使用稳定版本**：如 `6.0.0` 而非里程碑版（如 `7.1.0.M4`），除非明确需要新特性。 - **检查依赖树**：通过 `mvn dependency:tree` 确认无版本冲突。 ---