如何在Multer.diskStorage的filename配置中访问res.locals变量

问题根源 #

你现在遇到的问题是三个错误叠加导致的：

1. 你在createUser中间件里先调用了res.status(201).json()，该方法会直接结束当前HTTP响应，后续中间件即使执行也属于响应发送后的无效逻辑，且响应头/响应体已经不可修改。
2. 你已经在路由最前面调用了upload.any()，该方法已经解析了所有form-data数据，包括userImage文件流，后续的upload.single('userImage')已经拿不到未消费的文件流，重复调用Multer本身就是无效操作。
3. 你通过res.locals传递参数，却在Multer的filename回调里绕层从req.res取属性，不仅容易取值失败，也完全没必要。

解决方案 #

直接调整逻辑去掉重复的Multer调用，在用户创建完成后手动处理已经解析好的文件即可，修改步骤如下：

1. 调整路由配置，删除末尾无效的upload.single调用：

router.post('/create', upload.any(), createUser);

2. 修改createUser中间件逻辑，调整文件处理顺序，所有操作完成后再返回响应：

// 需提前引入node内置fs、path模块
const userImage = req.files.find(file => file.fieldname === 'userImage');
if (!userImage) {
  return res.status(400).json({ message: '缺少用户头像参数' });
}

const savedUser = await user.save();
const createdUserId = savedUser._id;

// 从文件原始名称取后缀，不要从req.body中取，body中只有普通文本字段
const imgExtension = path.extname(userImage.originalname);
const imgName = `${createdUserId}_profileImage${imgExtension}`;
const imgPath = `./images/profileImages/${imgName}`;

// 手动将Multer暂存的文件移动到目标路径
await fs.promises.rename(userImage.path, imgPath);

// 更新用户数据中的头像路径
await userModel.updateOne({_id: createdUserId},{
    image: {
        path: imgPath,
        contentType: userImage.mimetype
    }
});

// 所有操作完成后再返回响应
res.status(201).json({
    message: "User has been saved",
    userId: createdUserId
});

如果一定要保留原有的两次Multer调用逻辑，需要做两个修改：

• 把createUser中的res.json调用移到最后一个中间件里，不能提前返回响应
• 把拼接好的文件名直接挂载到req对象上：req.customImgName = imgName，在Multer的filename回调中直接取req.customImgName即可。

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