JMeter上传PDF返回成功响应但文件实际未上传如何排查解决

核心诱因 #

首先明确：请求中出现的<actual file content, not shown here>是JMeter查看结果树组件对二进制请求体的默认折叠展示逻辑，属于正常现象，不是上传失败的直接原因。
接口返回成功但文件实际未上传的本质是接口返回了假成功响应——后端校验逻辑存在漏洞，未完成全链路上传校验就返回成功提示，常见触发场景如下：

• HTTP请求采样器配置错误：上传参数名和接口要求不匹配、PDF对应的MIME类型填写错误（比如错填为text/plain），后端未识别到有效文件字段但未抛出错误
• 文件路径配置异常：使用相对路径填写PDF地址时，JMeter实际工作目录和预期不一致，未读取到目标PDF文件，实际传输的是空内容或无效内容
• 二进制内容被错误编码：勾选了文件参数对应的「Encode?」选项，导致PDF二进制内容被URL转码损坏，后端收到的文件内容乱码，无法正常解析落盘
• 请求头配置冲突：手动给请求添加了Content-Type: multipart/form-data请求头，但未携带自动生成的boundary参数，后端无法正确解析multipart请求体，未捕获异常就返回通用成功响应
• 后端校验逻辑缺失：仅校验请求中是否存在文件字段，未校验文件格式合法性、存储写入结果，提前返回成功响应

排查解决步骤 #

• 第一步：确认文件加载正常
  将PDF文件路径改为绝对路径测试（例如C:/test/xxx.pdf），排除相对路径的工作目录匹配问题；可临时搭建本地简易文件接收服务，接收JMeter发出的请求，对比传输的文件大小、MD5值和本地源文件是否一致，确认文件被正确加载读取。
• 第二步：修正采样器配置
  上传请求为POST类型时，勾选「Use multipart/form-data for POST」选项，不要手动添加Content-Type请求头，JMeter会自动生成带合法boundary参数的请求头；文件上传配置区的参数名必须和接口要求完全一致，MIME类型填写application/pdf，取消勾选文件参数对应的「Encode?」复选框。
• 第三步：对比合法请求校准参数
  通过浏览器、官方客户端完成一次正常的PDF上传，抓包获取合法请求的请求头、表单参数、multipart分块结构，和JMeter的请求逐一比对，补全遗漏的必填认证参数、业务表单字段，匹配参数格式要求。
• 第四步：对齐后端校验逻辑
  查看后端服务上传链路的运行日志，确认是否存在文件解析失败、存储写入失败的报错记录，如果是后端未完成全链路校验就提前返回成功，需要补全文件格式校验、落盘结果校验逻辑，所有校验通过后再返回成功响应。

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