使用 jackson 的 objectmapper 将 java 字符串写入输出流时，会自动将其作为 json 字符串序列化，导致双引号和斜杠被转义；若目标是直接输出原始 json 文本，不应使用 writevalue()，而应选择直写或结构化建模方式。
Jackson 的 ObjectMapper.writeValue(OutputStream, Object) 方法设计初衷是将任意 Java 对象序列化为合法的 JSON 表示。当你传入一个 String 类型（如 "{"test":"mytest/123"}"），ObjectMapper 并不会将其视为“已格式化的 JSON”，而是将其当作一个字符串值进行 JSON 序列化——即：包裹双引号、转义内部引号及特殊字符，最终输出类似 "{\"test\":\"mytest/123\"}" 的结果。这是完全符合 JSON 规范（json.org）的正确行为，而非 bug。
✅ 正确做法一：绕过序列化，直接输出原始字符串
若你已拥有合法 JSON 格式的字符串，且仅需原样打印或写入流，请避免使用 ObjectMapper：
OutputStream outputStream = new PrintStream(System.out);
String rawJson = "{\"test\":\"mytest/123\"}";
outputStream.write(rawJson.getBytes(StandardCharsets.UTF_8));
outputStream.write('\n'); // 可选：换行提升可读性
outputStream.flush();⚠️ 注意：确保字符串本身是语法正确的 JSON（推荐用 JsonParser 验证），否则下游解析可能失败。
✅ 正确做法二：用结构化数据代替字符串，交由 ObjectMapper 序列化
更推荐、更安全的方式是不拼接 JSON 字符串，而是使用 Java 对象（如 Map 或 POJO）表达语义结构，让 ObjectMapper 负责生成合规 JSON：
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
OutputStream outputStream = new PrintStream(System.out);
ObjectMapper objectMapper = new ObjectMapper();
// 方式 A：使用 Map（轻量、动态）
Map<String, String> data = Map.of("test", "mytest/123");
objectMapper.writeValue(outputStream, data); // 输出：{"test":"mytest/123"}
// 方式 B：使用类型安全的 POJO（推荐用于复杂/复用场景）
record MyOutput(String test) {} // Java 14+ record 示例
// 或传统 class（含 getter/setter）
objectMapper.writeValue(outputStream, new MyOutput("mytest/123"));该方式天然规避手动转义风险，支持日期格式化、空值处理（@JsonInclude）、字段重命名（@JsonProperty）等高级特性，也便于单元测试与维护。
❌ 错误认知澄清
- writeValueAsString() 和 writeValue() 在字符串处理上行为一致：均将 String 视为 JSON 字符串值，故无需刻意替换方法。
- 不要尝试通过 configure(JsonGenerator.Feature.ESCAPE_NON_ASCII, false) 等配置禁用转义——这影响的是 Unicode 输出，无法解决字符串值被双引号包裹的根本逻辑。
总结
| 场景 | 推荐方案 |
|---|---|
| 已有可信 JSON 字符串，仅需透传 | 直接 OutputStream.write() + UTF-8 编码 |
| 构建 JSON 内容（尤其含变量、嵌套、动态字段） | 使用 Map / POJO + ObjectMapper.writeValue() |
| 需要严格控制序列化行为（如忽略 null、格式化缩进） | 启用 objectMapper.enable(SerializationFeature.INDENT_OUTPUT) 等配置 |
坚持“数据即结构，而非字符串”，是写出健壮、可维护 JSON 处理代码的关键原则。
