在 spring boot 应用中集成 apache camel 3.20.1 后，启用 `camel.springboot.main-run-controller=true` 会导致 actuator 的 `/actuator/shutdown` 端点无法完成优雅关闭——jvm 持续挂起不退出，根本原因在于该配置意外启用了阻塞式主控制器线程。
Apache Camel 自 3.18 版本起已深度重构其 Spring Boot 集成机制，camel.springboot.main-run-controller 配置项实质上已被弃用。该属性原本用于在非 Web 环境下（如纯命令行应用）启动一个阻塞式主线程以维持 JVM 运行；但在标准的 Spring Boot Web 应用（尤其是启用 spring-boot-starter-web 和 spring-boot-starter-actuator）中，Spring 容器本身已通过内嵌 Web 容器（如 Tomcat）接管生命周期管理。此时若额外启用 main-run-controller=true，Camel 会启动一个独立的、不可中断的守护线程（通常表现为 CamelMainRunController），该线程在 Spring 上下文关闭后仍持续运行，从而阻止 JVM 正常退出。
✅ 推荐解决方案：彻底移除该配置
在 application.properties 或 application.yml 中删除或注释掉该行：
# ❌ 错误配置（导致 shutdown 卡住） camel.springboot.main-run-controller=true # ✅ 正确做法：完全删除此行，或显式设为 false（推荐显式声明以增强可读性） camel.springboot.main-run-controller=false
对应 YAML 格式：
camel:
springboot:
main-run-controller: false⚠️ 注意事项：
- 即使应用包含文件路由（如 from("file:...")）、定时任务（timer:）或长连接组件，只要使用标准 Spring Boot 启动方式（SpringApplication.run()），Camel Context 就会由 Spring 容器全权托管其生命周期——启动、健康检查、优雅关闭均由 Spring Boot Actuator 和 LifecycleProcessor 协调完成。
- camel.springboot.use-mdc-logging=true 是安全的，它仅影响日志上下文传递，与线程生命周期无关，可保留。
- 若你确实需要在无 Web 容器的场景下运行 Camel（例如批处理 CLI 工具），应改用 CamelMain 或 Quarkus 等更轻量级启动模式，而非依赖 main-run-controller。
? 验证是否修复：
启动应用后，执行标准 Actuator 关闭命令：
curl -X POST http://localhost:8080/actuator/shutdown
预期响应为 {"message":"Shutting down, bye..."}，且应用进程在数秒内完全退出（可通过 jps -l 或进程监控确认）。若仍卡住，请检查是否有其他第三方 Starter（如某些旧版 camel-quartz 或自定义 Thread 实例）未正确实现 SmartLifecycle 或未响应 stop() 调用。
总之，在现代 Spring Boot + Camel 架构中，main-run-controller=false 是默认且唯一推荐的行为。保持配置精简、遵循框架生命周期契约，是实现可靠优雅关闭的关键前提。
