调用火山引擎DeepSeek API返回空content需按三步排查：一是检查messages中role仅限system/user/assistant且首条不能为assistant；二是验证system提示词是否被安全策略拦截，可临时删除或简化测试；三是确认联网搜索版需显式添加布尔型"enable_web_search":true参数，流式响应须完整接收所有chunk并拼接。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
调用火山引擎 DeepSeek API 时返回空 content 字段（比如 {"content":""} 或流式响应中 delta.content 为空字符串），不是网络超时也不是密钥错误，而是模型在特定条件下主动拒绝生成内容，必须针对性排查和修复。
检查请求体中的 messages 是否含非法角色
第一步：确认 messages 数组里每个对象的 role 字段值只能是 【system、user、assistant】 三者之一，且不能重复出现 assistant 角色（尤其不能以 assistant 开头）。
第二步：打开你发给 API 的原始 JSON 请求体，逐行核对——如果发现 role: "bot"、role: "ai"、role: "model" 或 role: ""，立刻改成 role: "assistant"。
第三步：特别注意：若 messages 第一个对象是 role: "assistant"，API 会直接忽略整个对话并返回空 content，这是硬性校验规则，不报错但静默失效。
验证 system 提示词是否触发了安全拦截
方法一：临时删掉整个 system 消息对象再发一次请求。如果 content 突然有值了，说明原 system 提示词被火山引擎的内容安全策略拦截了——比如含“绕过审核”“伪造身份”“生成违法信息”等敏感指令，哪怕只是测试用的玩笑话也会被过滤。
方法二：把 system 内容换成最简版本，例如 {"role":"system","content":"You are a helpful assistant."}，再测试。这一步能快速定位是否为提示词问题。
注意：【system 消息不是必需项，删掉它不会影响基础功能】，生产环境建议先去掉再逐步加回，每次只加一句，直到复现空内容为止。
确认是否误用了联网搜索专属 endpoint
如果你调用的是火山引擎提供的 DeepSeek-R1 联网搜索版（Endpoint ID 以 ep-s-web- 开头），但请求体中没带 "enable_web_search": true 参数，API 会返回空 content 而非报错。
解决办法：在请求 JSON 的根层级显式添加该字段，值必须为布尔型 true，不能写成字符串 "true"。
示例正确写法："enable_web_search": true。
错误写法："enable_web_search": "true" 或漏掉该字段。
检查 stream=true 时的响应解析逻辑
当启用流式响应（stream: true）时，API 返回的是多段 data: 块，每块可能只含部分文本，甚至首块 content 为空（仅含 reasoning_content 或 role 字段）。
不要只取第一个 data: 块的 content 值——必须持续读取直到收到 finish_reason 字段为 "stop" 或 "length" 的 chunk，再拼接所有 delta.content 才能得到完整结果。
常见错误：前端或脚本收到第一帧就终止监听，导致拿到空字符串。
