火山引擎API响应体混入JSON外文字导致前端解析失败，需开启Strict JSON Mode、添加Accept: application/json请求头，或服务端用json.NewEncoder、重定向日志至stderr、启用response_format={"type":"json_object"}参数解决。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
火山引擎API返回的响应体里混入了JSON之外的说明文字，导致前端解析失败或触发400错误——你没改代码逻辑，但某次升级后突然报错，问题就出在响应体不再是纯JSON。
确认火山引擎是否启用了纯JSON模式
登录火山引擎控制台 → 进入「方舟平台」→ 找到你调用的模型服务 → 点击「配置管理」→ 查看「响应格式」开关是否已开启「Strict JSON Mode」。该选项默认关闭，未开启时，部分调试型接口（如/coding/v3/completions）会在JSON外包裹一层{ "code": 0, "message": "success", "data": { ... } }结构，而data内部才是你要的纯JSON。
如果开关为灰色不可点，说明当前模型版本不支持纯JSON直出，需切换至ark-code-latest或doubao-seed-2.0-code等明确标注「JSON-Only」的模型ID。
客户端强制声明期望纯JSON响应
在HTTP请求头中添加：【Accept: application/json】。仅靠Content-Type不足以约束响应格式，Accept才是告诉后端“我只接受application/json类型的响应体”。
若使用curl测试，必须带上-H 'Accept: application/json'；若用axios，需显式设置headers.Accept = 'application/json'；UnityWebRequest则必须调用setRequestHeader("Accept", "application/json")。
漏掉这行头，火山引擎可能按默认行为返回带code/message包装的混合结构，即使你传的payload是合法JSON，响应仍不纯净。
服务端侧绕过包装层（适用于自建网关或MCP Server）
方法一：用json.NewEncoder(w).Encode替代json.Marshal + w.Write
直接写入ResponseWriter底层连接，跳过中间[]byte分配，确保输出流无额外字符。此方式要求payload本身已是合法JSON对象，不能是map或struct——否则Encoder会自动加换行和空格，虽合法但不符合“前后无解释”的硬性要求。
方法二：在MCP Server的stdio协议处理层截断stderr与stdout
火山引擎MCP Server通过stdio通信，【日志必须写入stderr，协议响应必须只走stdout】。若你在cli执行逻辑中误将log.Printf(...)或fmt.Println(...)打到stdout，就会污染JSON响应流。检查所有日志输出语句，强制重定向至os.Stderr。
方法三：启用response_format={"type": "json_object"}参数（限OpenAI兼容接口）
当调用地址含/openai-completions路径时，在messages外层追加该字段。火山引擎会校验LLM输出并自动修复JSON语法，同时剥离所有非JSON前导/尾随文本（包括```json、注释、说明句）。注意：该参数仅对ark-code-latest等支持OpenAI Schema的模型生效。
