必须先确认真实框架版本和构建工具，再配置strict兼容模式的grok-migrate.yaml，执行迁移后验证@path转换与/q/health端点是否正常。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
识别待迁移代码结构与技术栈断层
先确认老项目真实依赖和运行时行为，避免仅靠文件名或注释误判框架版本。打开终端进入项目根目录，执行 grep -r "SpringBoot" . --include="*.java" | head -n 3 查看是否真为 Spring Boot 2.x 项目；若返回空，则继续检查 mvn dependency:tree | grep -i "spring-web"，确认实际引入的 spring-web 版本号。这一步不能跳过，【很多团队把 Spring MVC 项目误标为 Spring Boot，导致后续迁移模板完全错配】。
同时检查构建工具：运行 ls -la | grep -E "(pom\.xml|build\.gradle|Cargo\.toml)"，明确是 Maven、Gradle 还是其他体系。若存在 pom.xml 且含 <parent>...spring-boot-starter-parent</parent>，才可启用 Grok 的 Spring Boot 专用迁移通道。
配置Grok迁移任务参数
在项目根目录新建 grok-migrate.yaml，按以下结构填写：
source_framework: "spring-boot-2.7"target_framework: "quarkus-3.15"entry_point: "src/main/java/com/example/App.java"excluded_paths: ["src/test/", "target/", ".git/"]api_compatibility_mode: strict
其中 api_compatibility_mode 必须设为 strict，否则 Grok 会跳过对 @Scheduled 等非标准注解的兼容性校验，导致迁移后定时任务静默失效。该字段不支持缩写或布尔值，必须完整拼写为字符串。
执行迁移并验证关键路径
第一步：启动迁移代理
在终端运行 grok migrate --config grok-migrate.yaml --output-dir ./quarkus-migrated，等待进度条达到 100% 后，检查输出目录中是否生成了 src/main/resources/application.properties 和 src/main/java/com/example/RestEndpoint.java。
第二步：验证 HTTP 入口转换是否正确
打开新生成的 RestEndpoint.java，确认原 Spring 的 @RestController 已转为 @Path("/api")，且每个方法上方的 @GetMapping("/users") 已转为 @GET @Path("/users")。若仍残留 @RequestMapping 或未拆分 @Path，说明模型未识别到 Quarkus 的 JAX-RS 标准，需回退并手动在 grok-migrate.yaml 中添加 force_jaxrs: true 字段。
第三步：运行轻量级契约测试
进入 ./quarkus-migrated 目录，执行 ./mvnw compile quarkus:dev 启动开发服务器。另开终端，用 curl -v http://localhost:8080/q/health 检查健康端点是否返回 {"status":"UP"}。这一步失败意味着生命周期管理器未正确注入，需检查 src/main/resources/META-INF/quarkus-config.properties 中是否遗漏 quarkus.arc.enabled=true。
