Java格式化JSON字符串的实用方法

Java中手动拼接JSON字符串极易因忽略双引号、反斜杠、换行符等JSON严格转义规则而生成非法JSON，导致前端SyntaxError或后端JsonParseException；真正安全高效的做法是摒弃+号或StringBuilder硬拼，转而使用Jackson的ObjectMapper.writeValueAsString()——它自动处理所有字符转义、Unicode编码及格式化（如缩进），既避免双重转义陷阱，又覆盖JSON规范全部边界情况，哪怕面对动态结构也应优先建模为Java对象或JsonNode交由序列化器处理，而非冒险手工控制引号与转义。

Java里直接拼接JSON字符串会出什么问题

别用 + 或 StringBuilder 手动拼JSON——哪怕只是加个换行或引号，稍不注意就生成非法JSON。常见现象是：前端解析报 SyntaxError: Unexpected token，或者后端反序列化抛 JsonParseException。根本原因是JSON对双引号、反斜杠、换行符（\n、\r）有严格转义要求，而Java字符串字面量和输出流不会自动处理这些。

用 ObjectMapper 是最稳的格式化方式

Jackson 的 ObjectMapper 不仅能序列化对象，还能安全处理原始字符串内容。关键不是“怎么转义”，而是“让序列化器替你管好所有边界字符”。

• 对纯字符串内容，用 objectMapper.writeValueAsString() 包一层，它会自动加外层双引号并转义内部特殊字符
• 需要换行缩进？启用 SerializationFeature.INDENT_OUTPUT，不是自己塞 "\n"
• 如果输入已经是合法JSON字符串（比如从DB读出的），先用 objectMapper.readTree() 解析成树，再写回——避免双重转义

示例：

ObjectMapper mapper = new ObjectMapper();
mapper.enable(SerializationFeature.INDENT_OUTPUT);
String safeJson = mapper.writeValueAsString("hello\n\"world\""); // 输出："hello\\n\\"world\\""

手动拼接时必须逃开的三个坑

真要拼（比如动态键名、极简场景），以下三点漏一个就崩：

• " 必须写成 \"，但Java里得写成 "\\\""（两个反斜杠+一个引号）
• \n 在JSON里必须是 \\n，不是字面上的换行；否则解析器看到真实换行会直接报错
• 中文等Unicode字符不用手动转 \u4f60，ObjectMapper 会处理；手动拼时若硬编码 \u 序列，容易因编码不一致出乱码

别信 String.replace() 处理JSON转义

有人想用 str.replace("\"", "\\\"") 自己转义，这方法在绝大多数情况下失效：

• 只替换双引号，漏掉 \、\b、\f、\r、\n 等所有JSON要求转义的字符
• 如果原字符串里已有 \\（比如Windows路径），replace() 可能把 \\\\ 错误变成 \\\\\\
• 没有上下文判断——该转义的是JSON值里的引号，还是键名里的、还是注释里的（JSON本就不支持注释）

真正需要“字符串→安全JSON值”的场景，就老实用 objectMapper.writeValueAsString(str)，它背后调的是标准JSON转义逻辑。

复杂点在于：当JSON结构本身是动态拼出来的（比如嵌套多层map+list混合），人容易下意识去“控制每个引号”，其实应该把数据建模为Java对象或JsonNode，再交给序列化器——手工控制转义永远比不过标准实现的覆盖度。

到这里，我们也就讲完了《Java格式化JSON字符串的实用方法》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！