如何在Postman中测试含文件与参数的Spring Boot API？

你的接口采用@RequestParam接收字符串类型的data和文件类型的avatar，因此不能同时使用raw JSON和form-data模式，必须统一用form-data传递所有参数，且data的JSON结构需与服务层解析逻辑匹配。具体操作步骤如下：

Postman配置步骤 #

1. 设置请求方法为POST，填写完整接口地址（如http://localhost:8080/create）
2. 切换到Body标签，选中form-data选项
3. 添加两个参数：
   • 参数1：键名填data，类型选择Text，值填入单个对象的JSON字符串（不要包裹数组，服务层直接解析根节点的属性）：

     {
         "number": "987",
         "body": "body is the best part",
         "title": "title is so important part"
     }
     

     注：由于服务层用asText()读取number，这里传数字或字符串均可，建议传字符串避免类型转换问题。
   • 参数2：键名填avatar，类型选择File，点击右侧选择本地要上传的文件（该参数为非必填，也可省略）
4. 点击Send发送请求

额外注意事项 #

• 不要混合使用raw JSON和form-data模式，multipart/form-data类型的请求只能通过form-data传递所有参数
• 修复Controller中的空指针隐患：将if (!obj.equals(null))改为if (obj != null)，否则当obj为null时调用equals()会抛出空指针异常
• 确保uploadDir目录存在且有写入权限，保证saveAttachment方法能正常完成文件存储

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