Cloud Function上传Flutter图片报错ENOENT：文件或目录不存在

1. Flutter客户端文件路径传递逻辑错误 #

• image_picker获取的是客户端本地路径（iOS沙盒/Android本地存储路径），这类路径仅在客户端有效，云函数环境根本无法访问，直接传递会触发路径不存在错误。
• 正确做法：不要传本地路径，改为将图片转为二进制数据（如base64编码）或通过multipart/form-data格式上传文件内容到云函数。

2. 云函数本地文件处理路径错误 #

• 如果云函数尝试读取未接收到文件的本地路径，必然触发ENOENT：
  • 用express框架时，需确保通过multer等中间件正确解析multipart/form-data，且multer指定的临时存储路径（如系统临时目录os.tmpdir()）存在且有读写权限。
  • 处理base64数据时，要正确解码并写入临时文件，注意临时目录的路径写法（避免硬编码固定路径，用os.tmpdir()动态获取）。

3. Cloud Storage目标路径配置错误 #

• 检查存储桶名称是否完整（如your-project-id.appspot.com），不要遗漏项目ID后缀。
• 目标路径避免非法格式：比如不要出现//images/xxx.jpg这类重复斜杠，或包含特殊字符的文件名。

4. 权限混淆导致的路径错误假象 #

• 云函数服务账号若无Cloud Storage写入权限，可能会返回类似“路径不存在”的错误（实际是权限被拒）。
• 确认服务账号已添加Storage Object Creator或Storage Admin的IAM角色。

代码示例参考 #

Flutter客户端（multipart上传方式） #

import 'dart:io';
import 'package:image_picker/image_picker.dart';
import 'package:http/http.dart' as http;

Future<void> uploadImage() async {
  final picker = ImagePicker();
  final XFile? image = await picker.pickImage(source: ImageSource.gallery);
  if (image == null) return;

  final uri = Uri.parse('https://your-cloud-function-url');
  final request = http.MultipartRequest('POST', uri);
  request.files.add(await http.MultipartFile.fromPath('image', image.path));
  
  final response = await request.send();
  if (response.statusCode == 200) {
    print('上传成功');
  } else {
    print('上传失败: ${response.statusCode}');
  }
}

Cloud Functions（Node.js+multer处理） #

const functions = require('firebase-functions');
const admin = require('firebase-admin');
const express = require('express');
const multer = require('multer');
const os = require('os');
const path = require('path');

admin.initializeApp();
const app = express();
const upload = multer({ dest: path.join(os.tmpdir(), 'uploads') });

app.post('/uploadImage', upload.single('image'), async (req, res) => {
  if (!req.file) {
    return res.status(400).send('未接收到文件');
  }

  const bucket = admin.storage().bucket('your-bucket-name.appspot.com');
  const destPath = `images/${Date.now()}_${req.file.originalname}`;

  try {
    await bucket.upload(req.file.path, {
      destination: destPath,
      metadata: {
        contentType: req.file.mimetype,
      },
    });
    res.status(200).send({ message: '上传成功', filePath: destPath });
  } catch (error) {
    console.error(error);
    res.status(500).send('上传失败');
  }
});

exports.uploadImage = functions.https.onRequest(app);

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