Postman测试文件上传接口时出现MissingPropertyException异常求助

我之前在Grails项目里测试文件上传接口时，也碰到过一模一样的报错！咱们一步步拆解问题、解决它：

核心问题分析 #

报错Cannot get property 'bytes' on null object本质是后端没有正确接收到上传的文件对象，所以调用bytes属性时才会抛出空指针相关的异常。你说“发送相同文件名仍未解决”，说明问题和文件名无关，大概率出在请求配置或后端参数匹配上。

排查与解决步骤 #

1. 检查Postman的请求配置（最常见原因）

文件上传必须用multipart/form-data格式，且参数名要和后端完全匹配：

• 确认请求方法是POST，URL正确指向/api/uploadExcel
• 切换到Body标签，选中form-data选项
• 找到你添加的文件项，重点检查Key的名称：
  • 比如你的Grails控制器里是用MultipartFile excelFile接收，那Postman里的Key必须是excelFile（大小写敏感！）
  • 确保文件确实被选中（不是空白的，Postman会显示文件名和大小）

2. 优化控制器代码，增加空值判断

不管前端配置是否正确，后端都要先校验文件是否存在，避免直接调用属性报错：

def uploadExcel() {
    // 这里的参数名要和Postman的Key完全一致
    MultipartFile excelFile = request.getFile('excelFile')
    
    // 先判断文件是否存在/非空
    if (!excelFile || excelFile.isEmpty()) {
        render status: 400, text: "请选择有效的Excel文件上传"
        return
    }
    
    // 安全获取文件字节
    byte[] fileBytes = excelFile.bytes
    
    // 后续的文件解析、业务逻辑...
    render status: 200, text: "文件上传成功，大小：${fileBytes.length}字节"
}

3. 排查拦截器/过滤器是否干扰请求

如果项目里有全局拦截器或过滤器，可能会修改请求参数导致文件对象丢失。可以临时禁用所有拦截器，再测试接口：

• 如果禁用后能正常上传，就逐个排查拦截器的逻辑，看是否有处理multipart请求时的错误。

4. 检查Grails的文件上传配置

如果上传的文件过大，Grails会默认拒绝，导致文件对象为null。可以在application.yml里调整上传限制：

grails:
    web:
        multipart:
            maxFileSize: 10MB  # 单个文件最大大小
            maxRequestSize: 10MB  # 整个请求的最大大小

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