Java Assert断言何时用

在 Java 里，断言（assert）是用于开发和测试阶段的调试工具，而不是用来做正常的程序逻辑校验。下面从什么时候用、什么时候不能用、常见误区几个方面说明。

一、Assert 是什么

assert condition;
assert condition : "错误信息";

• 默认是关闭的
• 需要在运行时显式开启：

java -ea MyApp
# 或
java -enableassertions MyApp

二、什么时候应该使用 Assert ✅

✅ 1. 检查**“永远不应该发生”的内部错误**

用于程序内部逻辑正确性，而不是用户输入或外部环境。

void process(int value) {
    assert value >= 0 : "value 不可能为负数";
    // 后续逻辑
}

含义是：

如果这里 value < 0，说明我的代码有 bug，而不是用户错了。

✅ 2. 验证私有方法的内部假设

private int divide(int a, int b) {
    assert b != 0 : "除数不能为 0";
    return a / b;
}

说明：

• b == 0 是程序逻辑错误
• 不是外部输入错误

✅ 3. 在开发 / 测试阶段快速发现 bug

• 单元测试
• 调试阶段
• 本地开发环境

比抛异常更轻量，只在开发时有效。

三、什么时候不应该使用 Assert ❌

❌ 1. 不要用 assert 做参数校验（非常常见错误）

// 错误示例
public void setName(String name) {
    assert name != null; // ❌
    this.name = name;
}

原因：

• assert 可能在生产环境关闭
• 用户传 null 是正常情况，不是程序 bug

✅ 正确做法：

public void setName(String name) {
    if (name == null) {
        throw new IllegalArgumentException("name 不能为 null");
    }
    this.name = name;
}

❌ 2. 不要用 assert 处理外部输入

• 用户输入
• 文件内容
• 网络数据
• 配置文件

这些都可能出错，要用异常。

❌ 3. 不要用 assert 控制业务流程

// 错误示例
assert user.hasPermission() : "无权限";
doSomething();

原因：

• 业务规则不能用可能被关闭的机制

✅ 用异常或返回结果：

if (!user.hasPermission()) {
    throw new SecurityException("无权限");
}

四、Assert vs 异常（关键区别）

一句话总结：

Assert 是给程序员看的，异常是给程序看的。

五、推荐的工程实践 ✅

✅ 使用原则（记住这几条）

1. 只在“我认为是 bug”的地方用 assert
2. 不用 assert 校验公开 API 参数
3. 生产环境需要校验的地方，永远用异常
4. assert 失败 = 程序有 bug

六、常见真实使用场景示例

示例 1：调试复杂算法

int result = compute(x);
assert result > 0 : "计算结果非法";

示例 2：不变式检查

class Stack {
    private int size;

    void push(int v) {
        size++;
        assert size >= 0 : "size 不可能为负";
    }
}

七、总结一句话

Java assert 只用于“调试阶段验证内部假设”，不是用来替代异常进行正常校验。

如果你愿意，我可以：

• 用 真实项目例子帮你判断该不该用 assert
• 对比 JUnit 断言 vs Java assert
• 讲 为什么 assert 默认是关闭的