Flutter使用Dio+ImagePicker上传图片至Laravel失败（Postman可成功）

让我来帮你排查这个问题！服务器返回500错误提示Undefined variable *name*，根源其实出在Flutter和Laravel的表单字段名不匹配上，咱们一步步来解决：

1. 核心问题：表单字段名不匹配 #

• 你的Laravel代码里明确判断的是$request->hasFile('image')，说明后端期望接收的文件字段名是image
• 但Flutter端Dio构建FormData时，用的键是"name"，这就导致Laravel完全找不到名为image的文件，自然不会执行$name的赋值逻辑，最后返回响应时就会抛出「未定义变量」的致命错误。

2. 修复Flutter端代码 #

只需要把FormData里的字段键从"name"改成"image"即可：

_uploadFile(File file) async { 
    String name = file.path.split('/').last; 
    var data = FormData.fromMap({
        // 这里把"name"改成"image"，和后端对应
        "image": await MultipartFile.fromFile(
            file.path,
            filename: name,
        ),
    }); 
    Dio dio = new Dio(); 
    await dio 
        .post("http://localhost:8000/api/upload-file", data: data) 
        .then((response) => print(response)) 
        .catchError((error) => print(error)); 
}

3. 额外的Laravel代码优化（可选但建议） #

为了避免类似未定义变量的问题，建议给$name设置默认值，同时规范响应格式：

public function uploadFile(Request $request) { 
    $name = null;
    if($request->hasFile('image')) { 
        $name = time()."_".$request->file('image')->getClientOriginalName(); 
        $request->file('image')->move(public_path('images'), $name); 
    } 
    return response()->json([ 
        'url' => $name ? asset("images/$name") : null,
        'status' => $name ? 201 : 400,
        'message' => $name ? 'Image saved' : 'Image failed to save' 
    ]); 
}

这样即使没有上传文件，后端也会返回友好的400响应，而不是直接抛出500错误。

4. 其他需要确认的细节 #

• 如果是真机测试Flutter，要把API地址里的localhost换成Laravel服务器的局域网IP（比如http://192.168.1.100:8000），否则真机无法访问本地服务器
• 确保Laravel项目的public/images目录存在，并且有写入权限（可以用chmod -R 755 public/images命令设置权限）

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