WSO2 APIM对接Django REST Framework时POST/PUT请求Payload丢失求助

核心日志位置与排查顺序 #

WSO2 APIM的日志集中在<APIM_HOME>/repository/logs/目录下，优先按以下顺序排查：

1. 访问日志（access.log） #

先确认请求的基础元数据是否正常：

• 查找对应POST/PUT请求的记录，检查Content-Length字段是否大于0（确认Postman发送的Payload已到达APIM）
• 验证Content-Type是否与后端预期一致（比如application/json、application/x-www-form-urlencoded）

2. 主服务日志（wso2carbon.log） #

通过access.log中获取的请求traceId，在wso2carbon.log中搜索匹配条目：

• 检查是否存在Payload解析错误、中介策略执行异常、端点转发失败等报错信息
• 确认APIM在处理请求时未触发任何过滤规则导致Payload被丢弃

3. 消息跟踪日志（wso2message.log） #

若前两步未找到问题，开启DEBUG级别的消息跟踪日志：

• 修改<APIM_HOME>/repository/conf/log4j2.properties，将logger.message.level设置为DEBUG
• 重启APIM后重新发送请求，查看日志中是否完整记录了请求Payload，以及转发至后端时的Payload是否存在

配置层面检查 #

1. API资源配置验证 #

• 确认POST/PUT资源的Request Media Type与请求的Content-Type完全匹配，不匹配可能导致APIM忽略Payload
• 检查是否添加了自定义中介策略，排查是否有脚本错误清空了请求Payload（比如错误的XSLT转换、序列中介逻辑）

2. 端点配置检查 #

• 验证端点URL是否正确，路径是否与后端服务的接口路径完全对齐
• 若使用HTTPS端点，确认APIM已正确导入后端证书，避免因SSL握手失败导致请求截断

3. Payload大小限制检查 #

查看<APIM_HOME>/repository/conf/deployment.toml中的Payload配置：

[apim.payload]
max_request_size = "10MB" # 确认该值大于你的请求Payload大小

若配置值过小，大Payload会被APIM截断为空

内容的提问来源于stack exchange，提问作者Ajith Nirmal