Node.js文件上传应用部署Heroku后无法保存，本地正常求助

你遇到的问题确实是Heroku环境下的典型场景，我来帮你一步步拆解解决：

问题根源 #

1. 目录不存在：Heroku的部署环境是全新的临时容器，你的代码直接指定upload目录作为存储路径，但这个目录在容器启动时默认不存在，导致multer无法写入文件。
2. 临时文件系统限制：哪怕你手动创建了upload目录，Heroku的文件系统也是临时的——当应用重启（比如部署新版本、平台自动调整资源时），所有上传的文件都会被清空，根本无法持久保存。

第一步：临时解决目录缺失问题 #

先让应用在Heroku上能正常运行，我们可以在代码里自动检查并创建upload目录：

修改你的代码，加入文件系统的目录处理逻辑：

'use strict';
const express = require('express');
const multer=require('multer');
const uuid = require('uuid').v4;
const fs = require('fs'); // 引入fs模块
const path = require('path'); // 引入path模块处理路径
const app = express();
let port=process.env.PORT || 8080;

// 确保upload目录存在，使用绝对路径更可靠
const uploadDir = path.join(__dirname, 'upload');
if (!fs.existsSync(uploadDir)) {
  fs.mkdirSync(uploadDir, { recursive: true }); // recursive参数会自动创建嵌套的父目录
}

var storage= multer.diskStorage({
 destination: function(req,file,cb){
 cb(null, uploadDir)
 },
 filename: function(req,file,cb){
 cb(null,`${uuid()}-${file.originalname}`)
 }
})
const upload = multer({ storage : storage});

app.use(express.static('Frontend'))
app.post('/upload', upload.array('file'),function(req, res){
 res.send({ status: 200, NumberofFileUploaded:req.files.length })
})

app.listen(port, ()=> console.log(`Server Listening ${port}`))

这样修改后，应用启动时会自动创建upload目录，能解决当前的报错，但要记住：上传的文件在应用重启后会全部丢失，这只是临时方案。

第二步：持久化文件存储（核心解决方案） #

要在Heroku上实现真正可用的文件上传，必须使用外部云存储服务，比如AWS S3、Cloudinary、Google Cloud Storage等。这里以Cloudinary为例，给你一个简单的实现思路：

1. 先安装相关依赖：

npm install cloudinary multer-storage-cloudinary

2. 修改代码，替换multer的本地存储为Cloudinary云存储：

'use strict';
const express = require('express');
const multer=require('multer');
const { CloudinaryStorage } = require('multer-storage-cloudinary');
const cloudinary = require('cloudinary').v2;
const app = express();
let port=process.env.PORT || 8080;

// 从环境变量读取Cloudinary配置，千万不要硬编码密钥！
cloudinary.config({
  cloud_name: process.env.CLOUDINARY_CLOUD_NAME,
  api_key: process.env.CLOUDINARY_API_KEY,
  api_secret: process.env.CLOUDINARY_API_SECRET
});

// 创建Cloudinary存储引擎
const storage = new CloudinaryStorage({
  cloudinary: cloudinary,
  params: {
    folder: 'heroku-file-uploads', // 你在Cloudinary里的存储文件夹名称
    public_id: (req, file) => `${Date.now()}-${file.originalname}` // 生成唯一文件名
  }
});

const upload = multer({ storage: storage });

app.use(express.static('Frontend'))
app.post('/upload', upload.array('file'),function(req, res){
 // 返回上传后的文件访问链接
 const fileUrls = req.files.map(file => file.path);
 res.send({ status: 200, NumberofFileUploaded:req.files.length, fileUrls: fileUrls })
})

app.listen(port, ()=> console.log(`Server Listening ${port}`))

3. 在Heroku的应用设置里添加环境变量：
   • CLOUDINARY_CLOUD_NAME：你的Cloudinary云名称
   • CLOUDINARY_API_KEY：你的Cloudinary API密钥
   • CLOUDINARY_API_SECRET：你的Cloudinary API密钥

这样修改后，所有上传的文件都会存储到Cloudinary的云存储中，即使Heroku应用重启，文件也不会丢失，完全符合生产环境的需求。

额外提示 #

• 永远不要在Heroku的本地文件系统存储需要持久化的数据，这是平台的设计限制，一定要用外部云存储。
• 如果你偏好AWS S3，可以使用multer-s3包实现类似的功能，核心思路和Cloudinary一致。

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