StringBuilder不能直接与SLF4J占位符{}配合使用，因日志框架仅识别独立参数对象而非拼接后的字符串；正确做法是将StringBuilder构建的值作为单独参数传入，与其他参数一同按序传递。
Java 中 StringBuilder 本身不支持直接与 SLF4J 或 Logback 的占位符 {} 配合使用，因为日志框架的占位符替换机制只识别传入的**独立参数对象**，而不是字符串拼接结果。如果你先用 StringBuilder 拼出完整字符串再传给 logger.info("msg: {}", str)，那 {} 就不会被替换——它只会原样输出 "msg: {}"，后面跟一个字符串，毫无意义。
占位符 {} 的工作原理
SLF4J 的 logger.info("key: {}, value: {}", key, value) 是靠编译时确定的参数个数 + 运行时类型擦除后的 Object 数组来匹配 {} 的。它不解析字符串内容，也不关心你这个字符串是不是 StringBuilder.toString() 生成的。
- ✅ 正确：传多个独立参数，框架自动按顺序填充
- ❌ 错误：先把所有内容拼成一个字符串，再当作单个参数传进去
为什么不要用 StringBuilder + toString() 去“模拟”占位符
比如这样写是无效的：
StringBuilder sb = new StringBuilder();
sb.append("user=").append(user).append(", action=").append(action);
logger.info("log: {}", sb.toString()); // 输出：log: {}（后面跟一个字符串，{} 不会被替换）
上面这行日志实际输出类似：log: {} user=john, action=login，或者更糟——取决于日志框架实现，可能直接忽略占位符，只输出字面量 log: {}。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
立即学习“Java免费学习笔记（深入）”；
正确配合方式：用 StringBuilder 构造复杂参数，再作为独立参数传入
如果拼接逻辑较重（比如循环组装 JSON 片段、条件字段拼接），可以用 StringBuilder 先构建某个字段值，然后把这个值作为占位符的对应参数传入：
- 先用
StringBuilder生成某个动态字段（如 detail 字符串） - 再把该字段和其他变量一起，按顺序传给 logger 方法
StringBuilder detail = new StringBuilder();
detail.append("{");
if (status != null) detail.append("\"status\":\"").append(status).append("\"");
if (code != null) detail.append(",\"code\":").append(code);
detail.append("}");
logger.info("reqId: {}, detail: {}", reqId, detail.toString()); // ✅ 占位符正常替换
更推荐的替代方案：避免过早拼接
多数场景下，不需要手动拼字符串。优先交给日志框架处理：
- 简单字段直接传参：
logger.info("name: {}, age: {}, tags: {}", name, age, tags) - 复杂对象可重写
toString()，或用 Jackson 序列化（注意性能） - 若需格式化（如日期、数字），用
String.format或MessageFormatter（SLF4J 内部用）但非必须
只有当拼接逻辑确实复杂、且不能拆解为多个参数时，才用 StringBuilder 构建单个参数值，再填入对应位置。
