应使用OpenJDK 11或Adoptium JDK 11 LTS，清理Maven本地仓库，预加载官方BOM依赖，并替换lombok-maven-plugin为maven-compiler-plugin配合lombok 1.18.30注解处理器。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在安装Qoder时遇到依赖冲突报错，导致安装中断或组件无法正常加载，则很可能是由于JDK、Maven或其他底层工具版本与Qoder的构建要求不匹配。以下是解决此问题的步骤：
一、验证并统一JDK版本
Qoder对Java运行环境有明确的版本约束，OpenJDK 17在部分场景下会导致注解处理器失效，而Qoder官方推荐使用OpenJDK 11或Adoptium JDK 11 LTS版本，以确保编译期和运行期行为一致。
1、执行命令检查当前Java版本：java -version
2、若输出显示为17或更高版本，需切换至JDK 11；可使用sdkman管理多版本：sdk install java 11.0.22-tem
3、设置默认版本：sdk use java 11.0.22-tem
4、验证生效：java -XshowSettings:properties -version 2>&1 | grep "java.version"
二、强制重置Maven本地仓库并清理缓存
Maven本地仓库（~/.m2/repository）中可能残留不兼容的快照版本或损坏的元数据，导致dependency resolution失败；清除后可迫使Maven重新解析所有依赖树，避免旧缓存干扰新安装流程。
1、备份原仓库（可选）：mv ~/.m2/repository ~/.m2/repository.bak
2、创建空白仓库目录：mkdir -p ~/.m2/repository
3、执行Qoder安装前的清理命令：mvn clean dependency:purge-local-repository -DreResolve=false
4、确认无残留锁定文件：find ~/.m2 -name "*.lock" -delete
Qoder Linux版是由阿里推出的智能体自主开发工作台，支持开发者通过定义需求即可让Agent团队“自动驾驶”，自主完成代码执行、验证与交付的全流程。其全新的Quest独立视窗集成了任务管理与状态追踪能力，并支持跨项目多任务并行处理，显著提升开发效率。此外，Qoder还提供专家团模式与团队级知识引擎，适配复杂开发场景。
三、启用Maven离线模式并预加载兼容依赖
当网络策略限制或镜像源不稳定时，Maven可能拉取到非预期版本的传递依赖；通过预先下载已验证兼容的依赖组合，并启用离线模式，可绕过动态解析过程，杜绝版本漂移。
1、下载Qoder官方指定的依赖清单（含pom.xml中声明的全部BOM版本）：curl -O https://qoder.dev/releases/qoder-deps-bom-2.8.3.pom
2、将BOM导入本地仓库：mvn install:install-file -Dfile=qoder-deps-bom-2.8.3.pom -Dpackaging=pom -DgroupId=io.qoder -DartifactId=qoder-bom -Dversion=2.8.3
3、安装时强制引用该BOM：mvn -s settings.xml -Dmaven.repo.local=~/.m2/repository -DskipTests -Dmaven.test.skip=true -Pqoder-full install
4、全程启用离线标志：mvn -o -Dmaven.repo.local=~/.m2/repository install
四、禁用冲突插件并替换注解处理器
Qoder构建链中集成的某些第三方Maven插件（如lombok-maven-plugin 1.18.20）与JDK 11存在字节码生成兼容性问题，会导致annotation processing failed类错误；临时禁用并改用标准JSR-269实现可跳过该环节。
1、编辑Qoder项目根目录下的pom.xml文件，定位到<plugin>块中含lombok-maven-plugin的部分
2、将其整个<plugin>节点注释或删除
3、添加替代配置：<plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-compiler-plugin</artifactId><version>3.11.0</version><configuration><source>11</source><target>11</target><annotationProcessorPaths><path><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><version>1.18.30</version></path></annotationProcessorPaths></configuration></plugin>
4、保存后执行：mvn compile
