Flutter从v1迁移至v3后使用file_picker上传文件报错求助

核心问题 #

报错Cannot retrieve length of file, path = 'null'的直接原因是：FilePicker选择文件时，你错误地引用了未赋值的path变量，导致传入_uploadFile的是null路径，最终MultipartFile.fromPath找不到文件。

分步修复 #

1. 修正FilePicker的变量引用

在_pickFile方法中，你拿到了PlatformFile file对象，但后续错误地使用了未定义的path变量，应该直接使用file.path：

_pickFile() async {
  FilePickerResult? result = await FilePicker.platform.pickFiles();
  if (result == null) return;

  PlatformFile file = result.files.first;

  print('File Name: ${file.name}');
  print('File Size: ${file.size}');
  print('File Extension: ${file.extension}');
  print('File Path: ${file.path}');

  // 增加path为空的判断，避免无效调用
  if (file.path == null) {
    // 可添加用户提示，比如"文件路径无效"
    return;
  }

  Navigator.pop(context);
  _uploadFile(file.path!); // 这里改为file.path
}

2. 增加上传前的参数校验

在_uploadFile方法开头增加路径有效性校验，提前拦截错误：

_uploadFile(String filename) async {
  // 先判断路径是否有效
  if (filename.isEmpty || filename == 'null') {
    // 提示用户文件路径异常
    return;
  }

  // 原上传代码
  var request = http.MultipartRequest('POST', Uri.parse(baseURL! + urlFiles));
  request.fields['apiKey'] = API_KEY;
  request.fields['username'] = username as String;
  request.fields['authenticationCode'] = authCode as String;
  request.files.add(await http.MultipartFile.fromPath('myfile', filename));

  var streamedResponse = await request.send();
  final response = await http.Response.fromStream(streamedResponse);

  if (response.statusCode == 200) {
    final responseJson = json.decode(response.body);
    // 后续业务处理
  }
}

3. 可选：跨平台兼容优化（推荐）

部分平台（比如Web）可能无法获取到本地文件路径，建议改用MultipartFile.fromBytes方式上传，无需依赖文件路径：

// 修改_pickFile，开启withData获取文件字节
_pickFile() async {
  FilePickerResult? result = await FilePicker.platform.pickFiles(withData: true);
  if (result == null) return;

  PlatformFile file = result.files.first;

  if (file.bytes == null) {
    return;
  }

  Navigator.pop(context);
  _uploadFileWithBytes(file.bytes!, file.name);
}

// 新增字节上传方法
_uploadFileWithBytes(List<int> bytes, String filename) async {
  var request = http.MultipartRequest('POST', Uri.parse(baseURL! + urlFiles));
  request.fields['apiKey'] = API_KEY;
  request.fields['username'] = username as String;
  request.fields['authenticationCode'] = authCode as String;
  
  // 使用fromBytes替代fromPath
  request.files.add(http.MultipartFile.fromBytes(
    'myfile',
    bytes,
    filename: filename,
  ));

  var streamedResponse = await request.send();
  final response = await http.Response.fromStream(streamedResponse);

  if (response.statusCode == 200) {
    final responseJson = json.decode(response.body);
    // 后续业务处理
  }
}

4. ImagePicker API适配（可选）

当前你使用的getImage已被废弃，建议替换为最新的pickImage方法：

_getPhoto(ImageSource source) async {
    // 替换getImage为pickImage
    var image = await ImagePicker().pickImage(source: source, imageQuality: 50);

    if (image == null) return;

    path = image.path;
    Navigator.pop(context);
    if (kDebugMode) {
      print('---> ImagePicker $path');
    }
    _uploadFile(path as String);
}

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