本文为完整实战文档，包含全流程，已脱敏处理隐私信息，可直接用于企业项目升级参考，复制即可发布至 CSDN。

本次升级以为核心，完成环境升级、依赖替换、代码迁移、问题修复，成功解决包名迁移、依赖冲突、Bean 异常、编译错误、文档失效五大类问题。项目实现编译成功、启动无报错、功能全覆盖、AI 正常运行，技术栈规范、稳定、可长期维护，可为同类 Spring Boot 3 升级项目提供完整参考方案。

故障根本原因第三方激活工具会向 JetBrains IDE 的用户级配置文件写入-javaagent参数，卸载 IDE、删除工具、清理环境变量都不会删除该配置，是导致启动失败的唯一元凶。关键踩坑点仅清理了Local目录的缓存 / 日志，完全忽略了Roaming目录的核心启动配置，这是 90% 开发者都会踩的坑。重要知识点JetBrains IDE 有两级配置文件：安装目录（优先级低）、用户Roam