StringJoiner 比 StringBuilder 更干净，因其将分隔符、前缀、后缀逻辑内聚封装，自动处理空集合、单元素等边界；add() 不接受 null，需提前过滤；支持复用与 setEmptyValue()（注意前缀/后缀仍生效）。
StringJoiner 为什么比 StringBuilder 拼接带分隔符的字符串更干净
因为 StringJoiner 把“分隔符逻辑”从拼接过程里抽出来了，你不用再手动判断是不是第一个元素、要不要加前缀后缀——它内置状态管理。而用 StringBuilder 手写分隔符，容易在空集合、单元素、null 元素时漏掉边界处理。
典型场景：把 List<string></string> 转成逗号分隔的字符串，且要求开头结尾不带多余逗号；或者拼 SQL 的 IN (?) 参数占位符。
- 空
StringJoiner调用toString()返回的是空字符串，不是null或异常 - 如果只传一个分隔符（如
new StringJoiner(",")），没有前缀/后缀，那它就等价于“纯分隔拼接” - 如果传了前缀/后缀（如
new StringJoiner(",", "[", "]")），那即使没添加任何元素，toString()也会返回"[]"
add() 方法遇到 null 会怎样？怎么安全处理
StringJoiner.add() 明确不允许 null，传入会直接抛 NullPointerException。这不是 bug，是设计选择——它假设你已对数据做过清洗。
常见错误现象：list.stream().map(obj -> obj.getName()).collect(Collectors.joining(",")) 看似安全，但换成 StringJoiner 手动 collect 就可能崩，因为没做 null check。
立即学习“Java免费学习笔记（深入）”；
在调试 Java 后端 API 故障时使用此技能，尤其适用于以下任务：分析日志、跨 Controller、Service 和 Mapper 层追踪请求、定位异常根因、检查 SQL 执行或参数流转，以及生成简洁的诊断结论与修复方案。
- 必须提前过滤或映射：用
Objects.toString(obj.getName(), "")替换 null 值 - 或者用
Stream.filter(Objects::nonNull)删掉 null 元素 - 别指望
StringJoiner自动跳过 null——它连空字符串""都照单处理，唯独卡在null
和 String.join()、Collectors.joining() 有什么实际区别
三者底层都用类似逻辑，但适用场景不同：String.join() 最轻量，适合一次性拼接已知集合；Collectors.joining() 绑定 Stream，适合函数式流水线；StringJoiner 是唯一支持「边 add 边维护状态」的可变对象。
性能差异微乎其微，但兼容性要注意： StringJoiner 是 JDK 8+，而 String.join() 也是 JDK 8+，但老项目若还在用 JDK 7，这俩都不能用。
- 需要中途决定是否加某个元素？用
StringJoiner，调add()前加 if 判断即可 - 要拼 SQL 的
WHERE a IN (?, ?, ?)，且参数个数不确定？StringJoiner可以先建好，循环中按条件 add，最后再套括号 -
Collectors.joining()无法复用，每次 collect 都新建内部 joiner；StringJoiner实例可复用、可重置（调setEmptyValue()或新建）
setEmptyValue() 容易被忽略的副作用
调用 setEmptyValue("N/A") 后，只要没调过 add()，toString() 就返回 "N/A"。但它**不会覆盖前缀/后缀**——如果构造时写了 new StringJoiner(",", "[", "]")，又设了 empty value，结果是 "[N/A]"，不是 "N/A"。
这个行为常被误以为是“兜底值”，结果线上日志里突然冒出一堆 "[N/A]"，排查半天才发现是空集合进了拼接流程。
- 只在明确需要“空时显示特定文字”且接受它被包在前后缀里时才用
setEmptyValue() - 如果只是想避免空字符串，通常不需要设——默认空
toString()就是""，比"N/A"更通用 - 一旦用了
setEmptyValue()，记得同步检查前缀/后缀是否合理，尤其在拼 JSON 或 SQL 片段时
真正麻烦的不是语法，是分隔符逻辑混在业务判断里时，人容易看漏那个“最后一个元素不该加分隔符”的分支。用 StringJoiner 不是为炫技，是把这种隐含状态显式托付给一个专管它的对象。
