怎么通过 System.exit() 传递不同的状态码以通知父进程或脚本当前的执行结果变量

Ja va 进程退出的“暗号”：如何用 System.exit() 状态码与操作系统对话

每个 Ja va 应用在结束运行的那一刻，都会向操作系统抛出一个整数——退出码。这个数字看似简单，却是父进程（Shell 脚本、CI 管道、Docker 容器、服务管理器）判断程序执行结果的唯一官方信号。如果程序跑完了却从不传递有意义的退出码，就像一个人离开了房间却不留任何口信，后续流程只能靠猜。

System.exit(int status) 是 JVM 的标准终止方式。它接受一个整数，然后把这个数字交给操作系统。父进程（比如 Shell 脚本、Jenkins、systemd）通过读取 $? 就能知道发生了什么：是正常结束、参数错了、配置文件丢了，还是数据库连不上。

常用状态码约定

POSIX 和绝大多数脚本环境遵循一套不成文的规则：

• 0：一切顺利，运行成功。
• 非 0 值（1–127）：表示某种失败或异常，具体含义由程序自己定义。
• 128+ 的值：通常被系统保留，例如 128 + 信号编号表示进程被信号杀死（比如 Ctrl+C 发送 SIGINT 即 2，退出码为 130）。Ja va 应避免使用这一区间。
• 负数：JVM 会将负数自动转为无符号字节（对 256 取模），比如 System.exit(-1) 实际返回 255，容易让人摸不着头脑，不推荐。

说白了，约定很简单：0 就是“OK”；非 0 就是“出事了”。具体什么事，由你编码。

在代码中按结果类型传递不同状态码

根据业务逻辑分支，用有意义的整数区分不同的失败原因，比笼统传一个 1 强得多：

• 处理成功 → System.exit(0)
• 参数错误（比如缺失必需参数）→ System.exit(1)
• 配置文件读取失败 → System.exit(2)
• 数据库连接异常 → System.exit(3)
• 网络请求超时 → System.exit(4)

数字可以继续往上编，但最好在文档或常量类里明确定义，避免后人猜谜。举个例子：

public class ExitCode {
    public static final int SUCCESS = 0;
    public static final int INVALID_ARGS = 1;
    public static final int CONFIG_ERROR = 2;
    public static final int DB_FAILURE = 3;
}

然后在代码里调用：System.exit(ExitCode.DB_FAILURE);。这样既清晰又便于全局修改。

Shell 脚本中捕获并响应状态码

在 Shell 里，执行完 Ja va 程序后立即检查 $? 变量即可拿到退出码：

ja va -jar myapp.jar
exit_code=$?
case $exit_code in
  0) echo "运行成功" ;;
  1) echo "参数错误，请检查输入" ;;
  2) echo "配置加载失败" ;;
  3) echo "数据库不可用" ;;
  *) echo "未知错误，退出码: $exit_code" ;;
esac

更简洁的写法是用条件判断，只在成功时继续后续步骤：

if ja va -jar myapp.jar; then
  echo "继续部署..."
  ./deploy.sh
else
  echo "构建失败，中止流程"
  exit 1
fi

这里 if ja va -jar 其实就是在悄悄检查 $?——0 视为 true，非 0 视为 false。

注意事项与最佳实践

几个容易踩的坑，值得记住：

• 不要在 finally 块或 shutdown hook 中调用 System.exit()，否则可能干扰正常的资源清理流程。
• 确保所有异常分支都明确了退出码。未捕获的异常默认返回 1，但有时连 1 都看不到——JVM 可能被信号杀掉，退出码变成 128+。
• 别用 System.exit() 做流程控制（比如用循环退出来模拟 goto）。正常用 return 或异常传播就够了，exit() 是给操作系统发信号的，不是给内部逻辑用的。
• 如果程序运行在 Docker 容器里，退出码会被容器引擎捕获，直接影响 Docker restart 策略和健康检查结果。比如容器退出码为 137（128 + 9，SIGKILL）会被视为 OOM 杀死。
• 日志里顺手输出退出码，对排查特别有用。比如: “Exiting with status 3 (DB_FAILURE)”。这样翻日志时一眼就能看出问题类型。

说到底，退出码是 Ja va 程序与外界沟通的最后一句“遗言”。给它一个清晰、一致的语义，后续的自动化流程就能精准地听懂你的意思。