System.exit()是JVM级强制终止指令，非优雅退出默认方案；它跳过finally、资源自动关闭及框架销毁逻辑，仅执行已注册的shutdown hook，适用于命令行完成或启动失败等进程级场景，禁用于Web应用。

System.exit() 不是“优雅退出”的默认方案，而是 JVM 级强制终结指令；真正优雅退出的关键，在于它如何与 shutdown hook、资源管理机制协同工作——而不是单独调用它。

System.exit 的真实作用：不是退出方法，是进程终止信号

它不走 Java 控制流，会立刻中断所有非守护线程，跳过 finally 块、try-with-resources 自动关闭、@PreDestroy、Spring Bean 销毁等全部清理逻辑。唯一能保证执行的，只有已注册的 shutdown hook。

• 适用于命令行工具完成任务、启动阶段致命错误（如 license 校验失败、核心配置缺失）等进程级终止场景
• 绝对禁用在 Web 应用（Spring Boot/Tomcat）、库代码、多线程业务逻辑中——它会干扰容器生命周期、导致连接泄漏、破坏健康检查
• 调用后后续代码永不执行，哪怕写在 return 后面或 try-catch 末尾也无效

退出码怎么设才靠谱：给操作系统看的契约

退出码不是内部状态标记，而是向 shell、CI/CD、Kubernetes 探针传递语义的接口，必须有明确约定。

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

• 只用 0–125 范围整数：0 表示成功；1 是通用错误，但建议细分（2=参数错、3=配置加载失败、4=网络不可达）
• 避免负数（System.exit(-1) 在 Linux 实际返回 255）、避免 126/127（shell 预留）、避免 128+（对应信号，如 130=Ctrl+C）
• 每个非零码需在项目文档中明确定义，否则对运维和脚本无意义

资源关闭不能靠 exit，得靠前置动作或 try-with-resources

System.exit() 不触发任何自动资源释放。文件未 flush、连接未 close、缓冲区未刷盘，都是常见数据丢失根源。

• 若必须调用 exit（如启动失败），先显式 close() / flush() / log.close()，再 System.exit()
• 优先使用 try-with-resources：编译器保障资源在作用域结束时关闭，哪怕中间调用了 System.exit() 也不影响
• 业务逻辑中禁止出现 System.exit()：应改用 return、抛异常、或 Spring Boot 的 SpringApplication.exit(ctx, code)

shutdown hook 是唯一可靠清理窗口，但要用对

它是 JVM 关闭流程中唯一可编程的清理入口，但不是万能兜底——它不保证执行完成，也不参与框架生命周期。

• 注册方式：Runtime.getRuntime().addShutdownHook(new Thread(() -> { /* 清理逻辑 */ }))
• 只做轻量、幂等、带超时的操作：如 threadPool.shutdownNow()、logger.flush()、标记服务下线
• 不要在 hook 中调用 System.exit() 或 Runtime.halt()；不要 join 其他线程；不要依赖已关闭的数据库连接或日志器
• 钩子不执行的场景：kill -9、JVM 崩溃、Runtime.halt() 调用——所以关键资源仍需前置关闭

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南