Node.js + Multer环境下第二次文件无法上传至FTP服务器问题求助

核心问题 #

使用multer-sftp包上传图片数组时，首次上传成功，第二次完全无法生效。

可能原因及修复方案 #

1. SFTP连接复用异常 #

multer-sftp默认可能复用SFTP连接，但首次上传后连接未正确重置或关闭，导致第二次请求时连接失效。

修复方法：
将sftp配置改为函数式返回参数，确保每次请求都初始化新连接：

const storage = sftpStorage({
    sftp: () => ({
        host: process.env.FTP_HOST,
        user: process.env.FTP_USER,
        password: process.env.FTP_PASSWORD,
        port: 22,
    }),
    destination: (req: any, file: any, callback: any) => {
        callback(null, "");
    },
    filename: (req: any, file: any, callback: any) => {
        callback(null, `${Date.now()}-${file.originalname}`);
    },
});

2. 全局挂载multer中间件的状态残留 #

全局挂载multer.array()可能导致中间件状态残留，第二次请求无法正确处理文件。

修复方法：
移除全局挂载，在具体路由中单独使用multer：

// 删除全局的app.use(multer(...))
const upload = multer({ storage: storage, fileFilter: fileFilter }).array("images", 8);

// 路由中使用
app.post('/upload', upload, (req, res) => {
    // 处理上传逻辑
    res.status(200).json({ message: '上传成功' });
});

3. 文件名冲突或目录权限问题 #

首次上传后，可能出现文件名重复，或目标目录权限发生变化导致写入失败。

排查与修复：

• 确认destination指定的目录存在且有写入权限
• 改用更唯一的文件名生成规则，比如UUID：

const { v4: uuidv4 } = require('uuid');

filename: (req: any, file: any, callback: any) => {
    callback(null, `${uuidv4()}-${file.originalname}`);
},

4. 未捕获上传错误 #

当前代码未处理multer-sftp的上传错误，第二次上传的异常被忽略，导致看起来“无法生效”。

修复方法：
在路由中添加错误捕获逻辑：

app.post('/upload', (req, res, next) => {
    upload(req, res, (err) => {
        if (err instanceof multer.MulterError) {
            return res.status(400).json({ error: err.message });
        } else if (err) {
            return res.status(500).json({ error: err.message });
        }
        // 上传成功逻辑
        res.status(200).json({ message: '上传成功' });
    });
});

总结 #

优先尝试函数式创建SFTP连接和路由级别挂载multer这两个方案，这是此类问题的常见诱因。若问题仍存在，通过错误捕获逻辑定位具体报错信息。

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