java Assert断言常见错误有哪些

在 Java 里，assert 是关键字级别的断言机制（不是 JUnit 的 Assert 类），使用不当很容易踩坑。下面按“常见错误 + 原因 + 正确做法”来说明。

1. 忘记开启断言（最常见）

错误示例

assert x > 0;

运行时什么也没发生，即使 x <= 0。

原因

Java 默认关闭断言，必须在运行时加参数：

java -ea Main
# 或
java -enableassertions Main

正确做法

• 调试/测试阶段开启 -ea
• 生产环境通常关闭（断言不能用于业务校验）

2. 用断言做参数校验（严重错误）

错误示例

public void setAge(int age) {
    assert age > 0;
    this.age = age;
}

问题

• 如果关闭断言，age 可能是非法的
• 违反“fail-fast”原则

正确做法

使用异常：

if (age <= 0) {
    throw new IllegalArgumentException("age must > 0");
}

✅ 断言只用于“不可能发生的情况”

3. 断言表达式有副作用

错误示例

assert list.remove(0) != null;

问题

• 开启/关闭断言，程序行为不一致
• 难以调试

正确做法

boolean removed = list.remove(0);
assert removed;

4. 用断言代替单元测试

错误示例

assert calculate() == 42;

问题

• 断言随时可能被关闭
• 测试不可靠

✅ 单元测试用 JUnit / TestNG：

assertEquals(42, calculate());

5. 断言信息写得太简单

错误示例

assert value != null;

更好的写法

assert value != null : "value must not be null, but it is";

✅ 第二个参数是错误信息，便于排查

6. 在 public 方法里用断言

错误示例

public void process(String input) {
    assert input != null;
}

原因

• public 方法可能被外部调用
• 断言不可靠

✅ public 方法用异常，private 方法可用断言

7. 忽略 AssertionError

错误示例

try {
    assert false;
} catch (AssertionError e) {
    // 忽略
}

问题

• 掩盖严重逻辑错误

✅ 不要 catch AssertionError

8. 用断言控制流程

assert condition;
if (!condition) {
    return;
}

❌ 逻辑冗余且危险

总结一句话

Java 断言只用于“内部逻辑保护”，不是校验工具，也不是测试工具。

如果你愿意，我也可以对比：

• Java assert vs JUnit Assert
• 断言在框架（Spring / JVM）中的使用误区