Netlify部署Node.js应用后图片上传失败：找不到uploads文件夹

问题核心 #

本地正常运行的图片上传功能，部署到Netlify后提示找不到uploads文件夹，本质是Netlify的运行环境特性导致的。

原因分析 #

1. Netlify文件系统限制：Netlify属于无服务器托管平台，提供的文件系统是临时且非持久化的，部署时不会自动创建uploads目录；即使手动创建，实例重启或重新部署后所有临时文件都会被清除。
2. 相对路径不兼容：本地的./uploads相对路径在Netlify部署环境中指向的位置和本地不一致，导致系统找不到指定目录。

解决方案 #

方案一：改用云存储（生产环境推荐） #

Netlify不适合存储用户上传的持久化文件，必须将文件上传到专门的云存储服务（如对象存储服务），步骤如下：

1. 修改multer配置，改用内存存储先读取文件：

const multer = require("multer");

// 用内存存储临时保存文件，后续上传到云存储
const storage = multer.memoryStorage();
const upload = multer({
  storage: storage,
  fileFilter: (req, file, cb) => {
    // 补充jpeg格式支持，避免遗漏
    const allowedTypes = ["image/png", "image/jpg", "image/jpeg"];
    if (allowedTypes.includes(file.mimetype)) {
      cb(null, true);
    } else {
      cb(new Error("仅支持JPG/PNG格式的图片"), false);
    }
  },
  limits: { fileSize: 1024 * 1024 * 2 }, // 限制2MB
});

module.exports = upload;

2. 在addProduct处理函数中，将内存中的文件上传到云存储服务，获取文件的在线URL后，将URL存入数据库（而非本地文件路径）。

方案二：临时测试方案（仅用于验证功能） #

如果只是临时测试，可以利用Netlify允许的临时目录/tmp，并确保目录在启动时自动创建：

const multer = require("multer");
const path = require("path");
const fs = require("fs");

// 根据环境选择上传目录
const isProduction = process.env.NODE_ENV === "production";
const uploadDir = isProduction ? path.join("/tmp", "uploads") : "./uploads";

// 确保目录存在，不存在则创建
if (!fs.existsSync(uploadDir)) {
  fs.mkdirSync(uploadDir, { recursive: true });
}

let storage = multer.diskStorage({
  destination: (req, file, cb) => {
    cb(null, uploadDir);
  },
  filename: (req, file, cb) => {
    let ext = path.extname(file.originalname);
    cb(null, Date.now() + ext);
  },
});

let upload = multer({
  storage: storage,
  fileFilter: (req, file, cb) => {
    const allowedTypes = ["image/png", "image/jpg", "image/jpeg"];
    if (allowedTypes.includes(file.mimetype)) {
      cb(null, true);
    } else {
      cb(new Error("仅支持JPG/PNG格式"), false);
    }
  },
  limits: { fileSize: 1024 * 1024 * 2 },
});

module.exports = upload;

⚠️ 注意：临时目录中的文件会在Netlify实例重启或重新部署后丢失，绝对不能用于生产环境。

内容的提问来源于stack exchange，提问作者TRI NI TY