Junit 5测试中断言IOException失败，求解决方案

1. 确认测试方法的异常断言写法正确 #

JUnit 5中必须使用assertThrows静态方法来捕获异常，不能沿用JUnit 4的expected注解。正确写法示例：

import static org.junit.jupiter.api.Assertions.assertThrows;
import org.junit.jupiter.api.Test;

public class PdfUtilTest {

    @Test
    void testPdfDocumentThrowsIOException() {
        // 传入必然触发异常的参数，比如不存在的文件路径
        String invalidFilePath = "non-existent-file.pdf";
        
        // 用assertThrows捕获目标异常
        IOException exception = assertThrows(IOException.class, () -> {
            PdfUtil.pdfDocument(invalidFilePath);
        });
        
        // 可选：验证异常信息是否符合预期
        assert exception.getMessage().contains("无法打开") || exception.getMessage().contains("文件不存在");
    }
}

2. 确保被测方法确实会向外抛出IOException #

检查PdfUtil.pdfDocument方法，避免内部吞掉异常导致测试无法捕获。

错误示例（内部捕获异常未抛出）：

public static PdfDocument pdfDocument(String path) {
    try {
        return new PdfDocument(new PdfReader(path));
    } catch (IOException e) {
        e.printStackTrace();
        return null; // 吞掉异常，测试时无异常抛出
    }
}

正确写法（直接抛出异常）：

public static PdfDocument pdfDocument(String path) throws IOException {
    return new PdfDocument(new PdfReader(path));
}

如果需要处理部分异常，也要确保特定场景下向外抛出IOException：

public static PdfDocument pdfDocument(String path) throws IOException {
    File file = new File(path);
    if (!file.exists()) {
        throw new IOException("目标文件不存在：" + path);
    }
    try {
        return new PdfDocument(new PdfReader(path));
    } catch (PdfException e) {
        // 转换为IOException抛出
        throw new IOException("PDF文件读取失败", e);
    }
}

3. 验证测试输入确实会触发异常 #

测试用例必须传入能触发异常的输入，比如：

• 不存在的文件路径
• 无读取权限的文件路径
• 损坏的PDF文件
• 空字符串或无效格式的路径

避免传入可正常读取的文件，否则方法不会抛出异常，测试必然失败。

4. 排查全局异常处理的干扰 #

如果项目中有全局异常拦截组件（如Spring的@ControllerAdvice），需确保测试环境不会加载这类组件，防止异常被提前拦截，无法传递到测试断言中。

内容的提问来源于stack exchange，提问作者WorkWork