1. 问题现象与背景解析最近在调试一个Python爬虫项目时遇到了一个典型的JSON解析错误。当向某电商平台API发送POST请求获取分页数据时服务器返回了以下报错信息JSON parse error: Unrecognized token pageNo: was expecting发送请求有汉字时解析错误这个错误表面看起来是JSON解析问题但实际涉及字符编码、请求头设置、参数格式化等多个技术环节。作为经常处理API对接的开发者这类问题其实有很典型的解决模式。下面我就结合具体案例拆解这个问题的完整排查思路和解决方案。2. 错误原因深度分析2.1 原始请求代码示例先看触发错误的原始代码片段import requests url https://api.example.com/products params { pageNo: 1, pageSize: 20, keyword: 手机 } response requests.post(url, dataparams) print(response.json())2.2 关键错误点诊断Content-Type缺失未显式设置请求头默认使用application/x-www-form-urlencoded参数编码问题中文字符手机未做URL编码处理数据格式错配服务器期望接收JSON格式请求体但实际发送的是表单数据重要提示现代API开发中90%的JSON解析错误其实都是由于请求头或数据格式不匹配导致的而非真正的JSON语法错误。3. 完整解决方案3.1 标准修复方案以下是经过验证的可靠实现方式import requests import json url https://api.example.com/products headers { Content-Type: application/json; charsetUTF-8 } params { pageNo: 1, pageSize: 20, keyword: 手机 } response requests.post( url, datajson.dumps(params, ensure_asciiFalse), headersheaders ) print(response.json())3.2 关键改进点说明显式设置Content-Type明确告知服务器发送的是JSON格式数据使用json.dumps转换将字典转为标准JSON字符串ensure_asciiFalse保留中文字符原样输出避免自动转义统一字符编码指定UTF-8编码避免乱码4. 高级调试技巧4.1 请求日志捕获在复杂场景下建议使用以下方式捕获完整请求详情import logging # 启用requests库的调试日志 logging.basicConfig(levellogging.DEBUG) requests_log logging.getLogger(requests.packages.urllib3) requests_log.setLevel(logging.DEBUG) requests_log.propagate True4.2 使用curl命令验证有时用命令行工具验证能快速定位问题curl -X POST \ -H Content-Type: application/json \ -d {pageNo:1,pageSize:20,keyword:手机} \ https://api.example.com/products5. 常见问题排查表现象可能原因解决方案JSON parse error1. 未设置Content-Type2. 数据未转为JSON字符串1. 添加正确请求头2. 使用json.dumps()中文乱码字符编码不一致1. 确保UTF-8编码2. 设置ensure_asciiFalse参数缺失数据格式错误检查使用data还是json参数400 Bad Request请求体格式错误用工具捕获原始请求对比6. 最佳实践建议始终显式设置Content-Type即使是简单请求也建议完整配置headers使用requests的json参数对于简单场景可以直接用requests.post(url, jsonparams)统一编码规范项目内所有API调用保持一致的编码处理方式添加异常处理对响应状态码和JSON解析增加try-catch块我在实际项目中总结出一个通用封装方法def safe_api_call(url, methodPOST, paramsNone): try: resp requests.request( method, url, jsonparams, headers{Content-Type: application/json}, timeout10 ) resp.raise_for_status() return resp.json() except requests.exceptions.RequestException as e: print(fAPI请求失败: {str(e)}) return None这个方案已经在我们团队的生产环境中稳定运行超过2年处理了各种复杂的API对接场景。记住好的请求处理应该像隐形的基础设施一样可靠让业务代码不需要关心网络通信的细节。
