本文详解 Flask 前后端交互中因 Content-Type 缺失或数据格式不匹配导致的 Expecting value: line 1 column 1 (char 0) JSON 解析错误，并提供可落地的修复方案、调试技巧与最佳实践。
本文详解 flask 前后端交互中因 content-type 缺失或数据格式不匹配导致的 `expecting value: line 1 column 1 (char 0)` json 解析错误，并提供可落地的修复方案、调试技巧与最佳实践。
该错误（Expecting value: line 1 column 1 (char 0)）是 Python json.loads() 或 Flask 的 request.get_json() 在尝试解析空、非 JSON 或无效编码的请求体时抛出的经典异常——本质是服务端未成功接收到合法 JSON 数据，而非前端 payload 构造本身有误。
? 根本原因分析
你的前端路由使用 requests.post(..., json=payload) 发送数据，这会自动：
- 序列化 payload 为 JSON 字符串；
- 设置 Content-Type: application/json；
- 将数据写入请求 body。
✅ 理论上无需手动加 header —— json= 参数已隐式完成。但实践中，某些代理、中间件或旧版 requests 库可能干扰 header 传递；更关键的是：后端 request.get_json() 要求请求必须满足两个条件：
- Content-Type 头明确为 application/json（严格匹配，不接受 text/plain 或缺失）；
- 请求 body 非空且为合法 UTF-8 编码 JSON。
而你的前端代码中 requests.post(..., json=payload) 是正确的，问题极可能出在：
- 后端接收逻辑未做容错（如 request.get_json() 返回 None 时直接 .get() 导致 AttributeError 或 KeyError）；
- 或请求被拦截/篡改（如 Nginx 未透传 header）；
- 或前端实际发送的并非 JSON（例如表单提交误用 multipart/form-data）。
✅ 正确修复方案
1. 前端：显式确保 JSON 头 + 容错处理
# 推荐写法：显式声明 headers（增强兼容性），并检查响应
try:
response = requests.post(
f'http://{BACK_END_IP}:{BACK_END_PORT}/add-user',
json=payload,
headers={'Content-Type': 'application/json'}, # 显式强化
timeout=10
)
# 关键：始终检查 response 是否可解析
if response.status_code == 200:
flash("Utilisateur ajouté avec succès.", "success")
return redirect('/')
else:
try:
error_data = response.json()
error_msg = error_data.get("error", "Erreur serveur inconnue")
except ValueError: # 响应不是 JSON（如 HTML 错误页）
error_msg = f"Serveur renvoyé un contenu invalide ({response.status_code})"
flash(f"Erreur : {error_msg}", "error")
return redirect('/')
except requests.exceptions.Timeout:
flash("Délai d'attente dépassé lors de la connexion à l'API.", "error")
except requests.exceptions.RequestException as e:
flash(f"Échec de la requête : {str(e)}", "error")
2. 后端：健壮解析 + 明确错误反馈
@app.route('/add-user', methods=['POST'])
def add_user():
current_user = get_user_from_token(request)
if not current_user or not current_user.admin:
return jsonify({"error": "Accès refusé : administrateur requis."}), 401
# ✅ 安全获取 JSON：容忍 None 并给出清晰错误
data = request.get_json(silent=True) # silent=True 防止 400 异常
if data is None:
# 检查是否为 form 提交（兼容性兜底）
if request.form:
return jsonify({"error": "Veuillez soumettre les données en JSON (Content-Type: application/json)."}), 400
else:
return jsonify({"error": "Corps de requête invalide : JSON attendu."}), 400
# ✅ 显式校验字段存在性（避免 .get() 返回 None 导致后续错误）
username = data.get('username')
email = data.get('email')
password = data.get('password')
if not all([username, email, password]):
missing = [k for k, v in {'username': username, 'email': email, 'password': password}.items() if not v]
return jsonify({"error": f"Champs manquants : {', '.join(missing)}"}), 400
# ... 其余业务逻辑（User 创建、db.commit 等）
3. 调试技巧：快速定位问题
-
打印原始请求信息（后端）：
print("Headers:", dict(request.headers)) print("Raw data:", request.get_data(as_text=True)) print("JSON parsed:", request.get_json(silent=True)) - Postman 验证：确保发送时 Body → raw → JSON，且 Content-Type 自动设为 application/json；
- 浏览器开发者工具：检查 Network → Payload 是否为纯 JSON 字符串（无引号包裹、无换行乱码）。
⚠️ 注意事项
- ❌ 避免混用 request.form 和 request.get_json()：前者用于 application/x-www-form-urlencoded 或 multipart/form-data，后者专用于 application/json；
- ❌ 不要对 request.get_json() 返回值直接调用 .get() 而不做 None 判断；
- ✅ 生产环境务必启用 silent=True 并配合状态码返回，而非让 Flask 抛 400 错误页面；
- ✅ 前端 requests 调用建议统一加 timeout，防止阻塞。
遵循以上方案，即可彻底解决 Expecting value 错误，构建健壮的前后端 JSON 通信链路。
