答案是字符编码未正确匹配所致。需依次排查：一、HTTP响应头是否声明charset=utf-8；二、服务端响应字节流是否真为UTF-8编码；三、客户端是否按UTF-8解码；四、Docker环境locale是否设为C.UTF-8；五、Tokenizer解码是否一致使用UTF-8。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您调用千问API获取响应，但返回内容中出现方块、问号、、é等异常符号，则很可能是由于字符编码未正确匹配所致。以下是针对该问题的系统性排查步骤：
一、检查HTTP响应头中的charset声明
服务端必须在Content-Type响应头中显式声明UTF-8编码，否则客户端可能按ISO-8859-1等默认编码解析字节流，导致中文解码失败。
1、使用curl命令查看原始响应头：
curl -v "https://your-api-endpoint/v1/chat/completions" -H "Authorization: Bearer YOUR_TOKEN" -d '{"model":"qwen3","messages":[{"role":"user","content":"测试"}]}'
2、在输出中定位Content-Type字段，确认其值为application/json; charset=utf-8而非仅application/json
3、若缺失charset=utf-8，需在服务端代码中强制设置响应头，例如在FastAPI中添加response.headers["Content-Type"] = "application/json; charset=utf-8"
二、验证服务端实际响应字节流是否为UTF-8编码
即使响应头声明了UTF-8，若服务端内部以GBK或其他编码写入响应体，仍会导致乱码。需确认原始字节序列符合UTF-8规范。
1、在服务端日志或调试器中捕获原始响应字节（bytes），例如Python中打印response_body[:20].hex()
2、对中文文本“你好”执行验证：正确UTF-8编码应为e4 bd a0 e5 a5 bd；若得到c4 e3 bac3等十六进制序列，则表明实际使用的是GBK编码
3、在模型输出后、序列化为JSON前，强制指定编码：json.dumps(data, ensure_ascii=False).encode("utf-8")
三、排查客户端解码环节是否误用非UTF-8编码
客户端接收HTTP响应后，若未按服务端声明的charset进行解码，或依赖系统默认编码（如Windows CMD为GBK），将直接引发乱码。
1、在Python requests调用中，显式设置r.encoding = "utf-8"，再调用r.text
2、在JavaScript fetch中，避免直接使用response.text()，改用：
const decoder = new TextDecoder("utf-8");
const text = decoder.decode(await response.arrayBuffer());
3、在Spring Boot应用中，确保配置spring.web.servlet.encoding.charset=UTF-8且spring.web.servlet.encoding.force=true
四、检查Docker或容器环境的系统locale设置
若服务部署于Docker容器中，基础镜像（如python:3.10-slim）可能未设置UTF-8 locale，导致Python运行时默认编码为ASCII，引发tokenizer解码异常。
1、进入容器执行locale命令，确认LANG和LC_ALL变量值为C.UTF-8或en_US.UTF-8
2、若显示POSIX或空值，在Dockerfile中添加ENV LANG=C.UTF-8 LC_ALL=C.UTF-8
3、重建镜像并重启服务，避免仅修改环境变量而不重建容器
五、验证Tokenizer与模型输出层的编码一致性
Qwen系列模型使用SentencePiece tokenizer，其词表文件（tokenizer.model）以UTF-8存储子词单元。若推理引擎加载时未启用UTF-8读取逻辑，或token ID解码过程绕过标准tokenizer.decode()，将导致字节映射错位。
1、在vLLM或transformers调用中，禁用自定义解码逻辑，始终使用model.tokenizer.decode(output_ids)
2、检查是否启用了fast tokenizer：设置use_fast=True，并确认tokenizer.json文件存在且完整
3、若使用Ollama，升级至0.5.7+版本，该版本已修复Qwen3系列在非Linux终端下的UTF-8输出截断问题
