
当方法内部自行捕获并处理异常(如 IOException)且不向外抛出时,AssertJ 的 assertThatThrownBy 无法检测该异常;此时应通过验证副作用(如数据库写入、日志记录或 mock 调用)来间接断言异常是否发生及其内容。
当方法内部自行捕获并处理异常(如 `ioexception`)且不向外抛出时,assertj 的 `assertthatthrownby` 无法检测该异常;此时应通过验证副作用(如数据库写入、日志记录或 mock 调用)来间接断言异常是否发生及其内容。
在单元测试中,若被测方法(如 method())选择“静默吞掉” IOException 并返回 false,同时将异常信息写入数据库——这意味着异常不会传播到测试层,因此 assertThatThrownBy(...).isInstanceOf(...) 必然失败(抛出 AssertionError: Expecting code to raise a throwable)。AssertJ 只能观测未被捕获、向上抛出的异常,对 catch 块内的逻辑无感知。
✅ 正确做法是:将异常处理行为解耦为可测试的协作对象,并在测试中通过 Mock 验证其交互。
示例:基于依赖注入与 Mockito + AssertJ 的完整验证
假设原方法重构为:
public class JsonProcessor {
private final DbWriter dbWriter; // 依赖注入,便于 mock
public JsonProcessor(DbWriter dbWriter) {
this.dbWriter = dbWriter;
}
public boolean processJson() {
try {
// 模拟 JSON 处理(可能抛出 IOException)
parseAndSaveJson();
return true;
} catch (IOException e) {
dbWriter.writeError(e.getMessage()); // 关键:副作用可观察
return false;
}
}
private void parseAndSaveJson() throws IOException {
// 实际逻辑...
throw new IOException("Failed to read config.json");
}
}
对应单元测试(使用 Mockito + AssertJ):
@Test
void processJson_whenIOExceptionOccurs_thenReturnsFalseAndWritesToDb() {
// Given
DbWriter mockWriter = mock(DbWriter.class);
JsonProcessor processor = new JsonProcessor(mockWriter);
// When
boolean result = processor.processJson();
// Then
assertThat(result).isFalse(); // ✅ 断言返回值
verify(mockWriter).writeError("Failed to read config.json"); // ✅ 断言副作用调用
// 进阶:还可校验调用次数
verify(mockWriter, times(1)).writeError(anyString());
}
⚠️ 注意事项与最佳实践
-
避免在测试中读取真实数据库:若无法 mock
DbWriter,务必使用内存数据库(如 H2)或事务回滚机制,确保测试隔离性与速度。 - 不要测试私有实现细节:不建议通过反射检查内部异常变量——这违反封装,且使测试脆弱。
-
日志场景可换用
LogCaptor:若异常信息写入 SLF4J 日志,可用logcaptor捕获并断言:LogCaptor logCaptor = LogCaptor.forClass(JsonProcessor.class); processor.processJson(); assertThat(logCaptor.getWarnLogs()).contains("Failed to read config.json"); - 返回值 + 副作用 = 完整行为契约:一个健壮的单元测试应同时覆盖「输出(return value)」和「影响(side effect)」,二者缺一不可。
总之,AssertJ 本身不支持“断言被吞掉的异常”,但通过良好的设计(依赖抽象、职责分离)和协作式测试(mock + verify),你完全可以精准、可靠地验证这类“捕获-处理-返回”模式的全部行为。










