摘要应包含目的、方法、结果和结论四要素，突出创新点，用第三人称客观简明表述，字数通常为100–300字，结构需完整且逻辑清晰。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在调用 DeepSeek V4 模型时设置了 system prompt，但模型输出未体现角色设定、风格约束或行为规范，则很可能是由于系统提示词未被正确识别或解析。以下是解决此问题的步骤：
一、确认 system prompt 是否处于 messages 数组首位
DeepSeek V4 严格要求 system 角色必须作为 messages 数组中的第一个元素，且 role 字段值必须为 "system"，content 字段需为纯字符串。若 system 消息位置靠后、缺失或被其他 role（如 user）前置，模型将跳过该指令。
1、检查请求体中 messages 数组的顺序，确保索引 0 的对象为 system 消息。
2、验证该对象结构是否符合：{"role": "system", "content": "你是一位严谨的医学文献校对专家"}。
3、删除 messages 中除首个以外的所有 system 类型消息，V4 不支持多个 system 条目。
二、避免使用顶层 prompt 或 system_prompt 参数
DeepSeek V4 的官方 API 接口仅接受 messages 数组作为对话输入源，不识别独立的 prompt、system_prompt 或 instruction 等顶层字段。若 SDK 封装层自动注入 system_prompt 参数，会与 messages 冲突并导致静默丢弃。
1、查看所用 SDK 文档，确认其是否兼容 V4 的 messages-only 协议。
2、手动构造原始 JSON 请求，绕过 SDK 的高层封装，直接发送包含 messages 的 payload。
3、在请求头中显式指定 Content-Type: application/json，防止因 MIME 类型错误引发解析降级。
三、校验 system content 的语法与编码完整性
system prompt 的 content 值必须为 UTF-8 编码的合法 JSON 字符串，不可含 BOM、零宽空格、换行符（\n）、制表符（\t）等不可见字符。任何格式污染都会导致整个 messages 数组被截断或忽略。
1、将 system content 复制至在线 JSON 校验工具（如 jsonlint.com）进行语法验证。
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
2、使用 Python 的 repr() 函数或 JavaScript 的 JSON.stringify() 输出原始字节序列，排查隐藏控制字符。
3、对中文内容强制执行 .encode('utf-8').decode('utf-8') 清洗操作，消除编码残留。
四、禁用客户端或代理层缓存机制
部分 HTTP 客户端库（如 requests.Session）或网关代理（如 Nginx、Cloudflare）会对相同结构的 POST 请求启用响应缓存，导致旧版 system prompt 被重复返回，造成“修改无效”的错觉。
1、在请求头中添加 Cache-Control: no-cache 和 Pragma: no-cache。
2、每次请求在 messages.content 中嵌入唯一时间戳片段，例如 "【v4-20260426T1006】你是一位法律文书专家"。
3、使用 curl 命令直连 API 地址，排除本地 SDK 缓存干扰，验证原始行为。
五、验证模型版本与 API 路径一致性
DeepSeek V4 对 system role 的支持仅限于特定 API 路径（如 /v1/chat/completions）及明确声明 model="deepseek-v4" 的请求。若调用路径指向 v2 或通用兼容接口，或 model 参数误设为 "deepseek-chat"，system 指令将被降级处理。
1、核对 API 请求 URL 是否包含 /v1/ 版本前缀，而非 /v2/ 或无版本路径。
2、检查请求体中 model 字段值是否精确匹配 "deepseek-v4"，注意大小写与连字符。
3、调用 GET /v1/models 接口，确认服务端实际加载的模型列表中存在 deepseek-v4 实例。
