JUnit 5 中如何断言异常消息匹配多个可能的字符串顺序_技术教程

本文介绍在 junit 5 测试中，当被测代码抛出的异常消息包含动态生成的、顺序不稳定的字符串（如集合差集元素）时，如何可靠地验证消息内容——既不依赖固定顺序，也不引入第三方库。

在使用 Preconditions.checkArgument 或类似校验逻辑时，若异常消息中嵌入了 Set 差集结果（例如 "The strings b, c, d are present in setA but not in setB"），而该 Set 使用 HashSet 实现，则其迭代顺序无保证，导致每次测试中拼接出的消息字符串顺序随机（如 "d, b, c"），进而使基于完整字符串匹配的断言（如 assertThrows(...).hasMessage(...)）间歇性失败。

✅ 推荐方案：解耦 + 可控输入（最佳实践）

最健壮的解决方案是从设计层面提升可测性：将集合参数化注入被测方法，而非在方法内部硬编码。这样测试时可主动传入 LinkedHashSet（保持插入顺序）或 TreeSet（自然排序），确保消息稳定：

public void funcSubSet(Set setA, Set setB) {
    Preconditions.checkArgument(setB.containsAll(setA),
        "The strings %s are present in setA but not in setB",
        Joiner.on(", ").join(setA.stream()
            .filter(Predicate.not(setB::contains))
            .sorted() // 强制排序，彻底消除顺序不确定性
            .iterator())
    );
}

测试时即可安全断言：

@Test
void testFuncSubSet_OrderStable() {
    Set setA = new LinkedHashSet<>(Arrays.asList("a", "b", "c", "d"));
    Set setB = new LinkedHashSet<>(Arrays.asList("a"));

    IllegalArgumentException ex = assertThrows(IllegalArgumentException.class,
        () -> funcSubSet(setA, setB));

    assertEquals("The strings b, c, d are present in setA but not in setB",
                 ex.getMessage());
}

? 提示：stream().sorted() 是更通用的保障手段，适用于任意 Set 实现，无需修改调用方的集合类型。

⚙️ 备选方案：细粒度消息断言（无代码修改时）

若无法修改被测方法签名或内部逻辑，可采用分段断言策略，避免强依赖完整字符串：

@Test
void testFuncSubSet_MessageContainsExpectedElements() {
    Exception ex = assertThrows(Exception.class, this::funcSubSet);
    String msg = ex.getMessage();

    // 验证固定前缀和后缀
    assertTrue(msg.startsWith("The strings "), "Message must start with prefix");
    assertTrue(msg.endsWith(" are present in setA but not in setB"), "Message must end with suffix");

    // 提取中间变量部分（去除前后固定文本）
    String variablesPart = msg.substring(
        "The strings ".length(),
        msg.length() - " are present in setA but not in setB".length()
    ).trim();

    // 验证每个预期元素均存在（忽略顺序与空格）
    Arrays.asList("b", "c", "d").forEach(expected ->
        assertTrue(variablesPart.contains(expected), 
                   "Message must contain '" + expected + "'")
    );

    // （可选）进一步校验元素数量
    long actualCount = Arrays.stream(variablesPart.split(",\\s*"))
        .map(String::trim)
        .filter(s -> !s.isEmpty())
        .count();
    assertEquals(3L, actualCount, "Exactly 3 missing elements expected");
}

? 注意事项与总结

避免 hasMessage() 的直接字符串匹配：当消息含非确定性内容时，它极易因顺序/空格/格式变化而脆弱。
优先重构被测代码：将集合作为参数传入，比在测试中做复杂解析更可持续。
LinkedHashSet ≠ 全局解法：仅当你能控制被测方法的输入集合类型时有效；若方法内固定创建 HashSet，则无效。
Assertions 足够强大：JUnit 5 原生 Assertions 已支持 assertThrows 返回异常对象，无需引入 AssertJ 即可完成精细断言。
日志友好性权衡：强制 sorted() 会略微影响运行时性能，但对测试场景可忽略，且显著提升调试体验。

通过以上任一方式，你都能让测试稳定通过，同时保持代码清晰、可维护，并符合单元测试“快速、确定、独立”的核心原则。