Java 的 assert 默认关闭,需用 -ea 参数启用;仅用于开发期调试,不可替代运行时校验;触发时抛出 AssertionError(属 Error,非 Exception),不应捕获恢复。

assert 在 Java 中默认是关闭的
Java 的 assert 语句在运行时默认不生效,哪怕代码里写了也不会触发。这是最容易被忽略的前提——很多人写了 assert x != null; 却发现程序崩溃时它根本没拦住,不是语法错,是开关没开。
启用方式只有 JVM 启动参数:加 -ea(即 -enableassertions)。例如:
java -ea MyApplication
如果只对某个包或类启用,可以更精确:
-
-ea:com.example.utils...—— 启用com.example.utils包及其子包 -
-ea:MyTest.class—— 只启用单个类 -
-da(-disableassertions)可用来局部关闭,优先级高于-ea
assert 语句的两种写法与触发条件
assert 是一条语句,不是方法调用,不能放在表达式里;它只在启用且布尔条件为 false 时抛出 AssertionError。
立即学习“Java免费学习笔记(深入)”;
两种合法形式:
-
assert condition;—— 如assert list != null; -
assert condition : detailMessage;—— 消息部分支持任意表达式,但仅在断言失败时求值,常用来避免副作用。例如:assert count > 0 : "count is " + count;
注意:condition 必须是 boolean 类型;写成 assert obj;(而 obj 是非布尔引用)会编译报错。
assert 不该用于校验用户输入或公共 API 参数
assert 的定位是“开发期辅助调试”,不是运行时契约检查。JVM 关闭断言后,所有 assert 语句直接被跳过,相当于不存在。
所以这些场景必须用显式检查:
- 方法入参合法性(如
Objects.requireNonNull(str, "str must not be null")) - 外部数据解析(如 JSON 字段缺失、HTTP 响应状态码异常)
- 任何可能影响程序正确性的运行时条件
误用 assert 替代真实校验,会导致上线后断言失效,错误悄悄穿透到下游,排查成本陡增。
AssertionError 和普通异常的区别与捕获风险
AssertionError 继承自 java.lang.Error,不是 Exception 子类。这意味着:
- 它不强制要求 try-catch,编译器不会提示你处理
- 常规
catch (Exception e)捕获不到它,必须显式写catch (AssertionError e) - 线上环境通常不期望捕获
Error,因为其出现往往意味着程序逻辑已处于不可靠状态
所以,不要在业务代码里试图“兜住” AssertionError 并恢复流程——它本就不是设计来被吞掉的。真遇到,说明开发期遗漏了关键检查,或者断言本身写错了条件。
真正该做的是:把高频触发的断言失败,转成明确的 IllegalArgumentException 或 IllegalStateException,并保留在生产代码中。










