当在 spring boot 应用中启用 camel 的 `main-run-controller` 配置时，会导致 actuator `/actuator/shutdown` 端点无法完成优雅关闭，jvm 持续挂起不退出；根本原因在于该配置启用了阻塞式主线程控制器，与 actuator 的 shutdown 生命周期机制冲突。
在基于 Spring Boot 2.7.x（如 2.7.8）并集成 Apache Camel 3.20.1 的 Web 应用中，若同时引入 spring-boot-starter-actuator 并启用 /actuator/shutdown 端点，常会遇到一个典型问题：调用 POST /actuator/shutdown 后，Spring 容器及 Camel 路由虽按序停止（日志显示 Stopping Camel routes、Closing ApplicationContext），但 JVM 进程并未终止——应用“假死”，需强制 kill 才能退出。
经排查，罪魁祸首正是 application.properties 中这一配置：
camel.springboot.main-run-controller=true
该配置源自 Camel 3.0 早期版本，用于在非 Web（如纯 Java main）环境中启动一个阻塞式主线程控制器（MainRunController），防止 JVM 在 Camel 上下文初始化后立即退出。但在 Spring Boot Web 应用中，此机制完全冗余且有害：Spring Boot 已通过嵌入式 Servlet 容器（如 Tomcat）维持主线程存活；main-run-controller 反而额外启动一个 Thread.sleep(Long.MAX_VALUE) 类型的守护线程，阻塞 JVM 正常关闭流程，导致 Runtime.getRuntime().addShutdownHook() 和 Spring 的 SmartLifecycle.stop() 无法最终释放进程。
✅ 推荐解决方案：直接移除该配置
# ❌ 删除或注释掉以下行（无需保留） # camel.springboot.main-run-controller=true # ✅ 其他推荐保留的 Camel 配置（无副作用） camel.springboot.use-mdc-logging=true camel.component.file.bridge-error-handler=true
⚠️ 注意事项： camel.springboot.main-run-controller=true 在 Spring Boot Web 应用中已完全过时，Camel 文档自 3.16+ 版本起明确建议仅在 camel-main（非 Spring Boot）场景下使用； 即使存在定时任务、异步消费者或文件轮询（如 file:// 路由），Camel 也会通过 Spring 的 Lifecycle 接口受控启停，无需手动干预主线程； 若误启用该配置后需快速验证修复效果，可执行标准 shutdown 流程：curl -X POST http://localhost:8080/actuator/shutdown # 观察日志末尾是否出现 "JVM exiting..." 或进程自动终止
? 总结：优雅关闭失效并非 Camel 或 Actuator 的 Bug，而是配置误用导致的生命周期冲突。正确做法是信任 Spring Boot 的容器管理能力，禁用所有非必需的阻塞式控制开关。保持配置精简（camel.springboot.main-run-controller=false 或直接省略，默认即为 false），即可恢复 Actuator shutdown 端点的预期行为——平滑停止组件、释放资源、安全退出 JVM。
