Multer在Nginx部署的Next.js服务器无法保存文件求助

核心问题分析 #

本地环境正常但部署到Nginx后Multer无法写入文件，且API返回成功、数据库已存文件名，大概率是相对路径导致的文件写入位置错误——本地开发时./public/uploads是相对于项目根目录，但部署环境中Next.js的执行工作目录可能并非项目根目录，导致文件被写到了一个未关注的路径里，而非预期的public/uploads。

具体修复步骤 #

1. 替换相对路径为绝对路径 #

使用Node.js的path模块生成绝对路径，确保无论执行环境如何，都能定位到正确的public/uploads目录。修改Multer配置如下：

const path = require('path');

const upload = multer({
    storage: multer.diskStorage({
        // 基于项目根目录生成绝对路径
        destination: path.resolve(process.cwd(), 'public', 'uploads'),
        filename: (req, file, cb) => cb(null, file.originalname),
    }),
});

2. 调整中间件执行顺序 #

确保安全中间件helmet()在Multer上传中间件之前执行，避免安全策略干扰文件上传流程：

// 先加载安全策略，再处理文件上传
apiRoute.use(helmet());
apiRoute.use(upload.single('image'));

3. 添加上传日志与错误捕获 #

在Multer配置和API路由中增加日志打印，确认文件处理状态：

const upload = multer({
    storage: multer.diskStorage({
        destination: path.resolve(process.cwd(), 'public', 'uploads'),
        filename: (req, file, cb) => cb(null, file.originalname),
    }),
    // 捕获Multer内部上传错误
    onError: (err, next) => {
        console.error('Multer上传错误:', err);
        next(err);
    }
});

// 在POST路由中打印文件详情
apiRoute.post(/* 鉴权中间件 */, async (req, res) => {
    try {
        console.log('上传文件详情:', req.file); // 确认文件是否被正确处理
        const img: string = req.file ? req.file.filename : ''
        // ... 后续业务逻辑
    } catch (error) {
        // ... 错误处理
    }
});

4. 验证服务器文件位置 #

登录服务器，执行命令查找可能被错误写入的文件：

find / -name "你的测试文件名"

如果找到文件在非预期目录，说明路径问题确实存在，绝对路径修改即可解决。

额外注意事项 #

• 确认Nginx进程运行用户（通常为www-data）对项目根目录及public/uploads有完整的读写权限。
• 检查Nginx配置，确保已正确映射public/uploads目录，避免上传后的文件无法被访问。

内容的提问来源于stack exchange，提问作者XAZG Неизвестный