本文介绍使用 JsonPath 的 flatten() 方法，将多层嵌套路径（如 "products.stock.availabilities.status"）返回的 List> 自动展平为 List，避免 ClassCastException，实现对不同 JSON 结构（单层/多层数组）的通用兼容。
本文介绍使用 jsonpath 的 `flatten()` 方法，将多层嵌套路径（如 `"products.stock.availabilities.status"`）返回的 `list>` 自动展平为 `list
在使用 REST Assured 或其他支持 JsonPath 的测试框架时，常通过 jsonPath().getList("path") 提取 JSON 中的值列表。但当目标字段位于嵌套数组中（例如每个 product 下有 stock.availabilities 数组，而每个 availability 又含 status 字段），直接使用 "products.stock.availabilities.status" 会返回 List —— 即外层是产品列表，内层是各产品下所有可用性状态的列表。此时若强制赋值给 >
List，JVM 将抛出 java.util.ArrayList cannot be cast to java.lang.String 异常。
根本原因在于：JsonPath 默认按 JSON 路径层级结构返回嵌套集合，而非扁平化结果。传统方案需手动双重遍历或类型检查，既冗余又易错。推荐解法是利用 JsonPath 内置的 flatten() 函数——它专为解决此类嵌套提取问题设计，可自动将多维列表展平为一维 List。
✅ 正确写法（简洁、通用、健壮）：
JsonPath jsonPath = response.jsonPath();
// 使用 .flatten() 后缀，自动处理任意深度嵌套数组
List<string> statuses = jsonPath.getList("products.stock.availabilities.status.flatten()");</string>
该表达式等价于 SQL 中的“UNNEST”，能无缝适配以下两种常见场景：
使用约定式提交（Conventional Commits）生成标准化的 Git 提交信息。适用于以下场景： (1) 暂存更改时需要提交信息； (2) 审查 diff 时希望获得结构化摘要； (3) 编写 PR 描述或变更日志（changelog）条目； (4) 用户明确要求“为本次更改编写提交信息”。 该功能会分析已暂存/未暂存的 diff，并生成按类型（type）划分范围的提交信息。
- 当每个
product仅含一个availability（即availabilities是单元素数组）→ 返回["IN_STOCK", "OUT_OF_STOCK", ...] - 当某
product含多个availability（如[{"status":"IN_STOCK"},{"status":"PRE_ORDER"}]）→ 同样正确展开为多个独立字符串
⚠️ 注意事项：
-
flatten()仅适用于路径最终指向数组内字段的场景（如.status），不可用于对象本身（如.availabilities.flatten()无效）； - 确保路径语法正确：
flatten()必须紧跟在字段名后，且中间无空格，如"products.stock.availabilities.status.flatten()"； - 若路径不存在或结果为空，
getList()返回空ArrayList，不会抛 NPE，但仍建议结合isEmpty()做业务校验； - 此方法无需额外依赖、不引入循环或泛型转换代码，天然支持参数化路径——你可将
"products.stock.availabilities.status"抽取为变量，动态拼接后调用.flatten()，真正实现“一套逻辑服务多种 JSON 结构”。
总结：面对 JsonPath 多层嵌套提取的类型不匹配问题，放弃手动类型判断与嵌套遍历，拥抱 flatten() 是最符合工程实践的解决方案——它以声明式语法消除复杂度，提升代码可读性与健壮性。
