System.exit(int)替代方案咨询：自定义错误码超int最大值问题

嘿，这个问题我之前做命令行工具时也碰到过类似的困扰——System.exit(int)确实把退出码死死限制在了int的范围内，而且就算你想绕开，底层操作系统本身对退出码也有隐性限制（比如Linux/Unix只认0-255的8位无符号整数，超过会自动取模截断）。不过有几个实用的方案可以满足你传递长整型自定义错误码的需求，我给你详细说说：

方案1：拆分错误码——用int做分类，标准流传完整码 #

这是最常用也最稳妥的方式：

• 用System.exit()返回一个int范围的分类码（比如0代表成功，1-100对应不同的错误大类，比如参数错误、IO错误、业务逻辑错误等）
• 在退出前，把完整的长整型错误码打印到System.err（标准错误流，和正常输出区分开），外部调用方可以通过读取这个输出来获取完整的错误信息

示例代码：

long fullErrorCode = 3000000000L; // 超出int范围的自定义错误码

// 先把完整错误码输出到标准错误流
System.err.printf("APP_FULL_ERROR_CODE: %d%n", fullErrorCode);

// 用int分类码退出，比如2代表业务逻辑错误
System.exit(2);

外部调用的脚本（比如bash）可以这样获取完整错误码：

# 运行应用，把标准错误流重定向到临时文件
java YourCommandLineApp 2> error.log

# 获取System.exit返回的分类码
exit_category=$?

# 从错误日志中提取完整错误码
full_error_code=$(grep "APP_FULL_ERROR_CODE:" error.log | cut -d' ' -f2)

方案2：封装自定义退出工具类，统一处理错误码 #

没必要去重写System.exit()（它是native方法，重写也绕不开底层限制），不如封装一个自己的退出工具类，统一处理长整型错误码的转换和输出：

public class AppExitHandler {
    public static void exitWithLongCode(long errorCode) {
        // 打印完整错误码到标准错误流
        System.err.println("CUSTOM_ERROR_CODE=" + errorCode);
        
        // 处理int范围转换：如果超过int最大值，映射到一个固定的错误码（比如255，系统允许的最大退出码）
        int exitCode;
        if (errorCode > Integer.MAX_VALUE || errorCode < Integer.MIN_VALUE) {
            exitCode = 255;
        } else {
            exitCode = (int) errorCode;
        }
        
        // 兼容系统限制：把退出码截断到0-255范围（Linux/Unix只识别这个区间）
        exitCode = exitCode & 0xFF;
        
        System.exit(exitCode);
    }
}

之后在应用里直接调用即可：

AppExitHandler.exitWithLongCode(5000000000L);

额外提醒：注意操作系统的退出码限制 #

很多开发者容易忽略：就算你用int范围的退出码，在Linux/Unix系统中，退出码实际上是8位无符号整数，超过255的话系统会自动对256取模。比如你传System.exit(256)，系统实际收到的退出码是0；传System.exit(257)，实际是1。所以如果你的外部调用方依赖System.exit的返回值做精确判断，其实最多只能用0-255的范围，超出的话还是得靠标准流传递完整信息。

内容的提问来源于stack exchange，提问作者Jasmeet Singh