java Assert断言如何调试

在 Java 中，assert 是一种调试和测试阶段使用的断言机制，默认在运行时是关闭的，所以很多人会觉得“assert 没生效 / 不会报错”。下面系统地讲一下 Java Assert 断言怎么用、怎么调试、常见坑。

一、Java 中断言的基本用法

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

示例：

int age = -1;
assert age >= 0 : "年龄不能为负数";

如果 age < 0，且断言已开启，会抛出：

java.lang.AssertionError: 年龄不能为负数

二、关键点：断言默认是「关闭」的 ⚠️

Java 的 assert 不会自动生效，必须在运行时开启。

开启断言的方式

1️⃣ 命令行运行

java -ea MyProgram

或只开启某个包：

java -ea:com.example... MyProgram

2️⃣ IDE 中开启（非常重要）

IntelliJ IDEA

• Run → Edit Configurations
• VM options 中添加：

-ea

Eclipse

• Run Configurations → Arguments → VM arguments

-ea

✅ 不开启 -ea，断言永远不执行（像没写一样）

三、调试 assert 的常用方法

1️⃣ 使用 AssertionError 的堆栈信息

assert list != null : "list 不能为 null";

报错后：

• 看 堆栈追踪
• 看 断言信息
• 定位是哪个条件失败

2️⃣ 把 assert 当成“调试开关”

assert debugPrint(x);

static boolean debugPrint(int x) {
    System.out.println("x = " + x);
    return true;
}

✅ 只在断言开启时打印

3️⃣ 和单元测试配合（推荐）

@Test
public void test() {
    int result = add(2, 3);
    assert result == 5;
}

⚠️ 注意：
JUnit 不依赖 assert 开关，但 JUnit 5 推荐用：

assertEquals(5, result);

四、assert 调试时的常见坑

❌ 1. 用 assert 做参数校验（生产环境会失效）

public void setAge(int age) {
    assert age >= 0; // 生产可能不生效
}

✅ 正确方式：

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

❌ 2. assert 里有副作用

assert list.remove(0) != null; // 危险

断言关闭时，这行代码不会执行

❌ 3. 以为 assert 会抛异常打断程序

• assert 抛的是 AssertionError
• 不属于 Exception
• 一般不会被 catch (Exception e) 捕获

五、什么时候该用 assert（调试建议）

✅ 适合：

• 内部逻辑假设
• 不可能发生的分支
• 调试阶段快速验证

❌ 不适合：

• 用户输入校验
• 业务逻辑错误
• 生产环境必须执行的检查

六、总结一句话

Java 的 assert 是用来“调试假设”的，不是用来做错误处理的；
不开启 -ea，它就等于不存在。

如果你愿意，可以告诉我：

• 你用的是 IDEA / Eclipse
• 是 普通程序 / Spring / 单元测试
• 遇到的具体报错

我可以给你更针对性的调试方案。