POST请求触发Unexpected Internal Server Error，排查Express投票者注册接口问题

代码中的直接错误 #

以下是控制器代码中导致500错误的核心问题：

1. Multer存储配置键名拼写错误 #

multer.diskStorage的配置键名应为destination，你误写为designation，这会导致multer无法识别存储目录，直接抛出文件存储错误：

// 错误写法
const storage = multer.diskStorage({
    designation: function (req, file, cb) {
        cb(null, 'images');
    },
    filename: function (req, file, cb) {
        cb(null, uuidv4() + '-' + Date.now() + path.extname(file.originalname));
    }
});

// 正确写法
const storage = multer.diskStorage({
    destination: function (req, file, cb) {
        cb(null, 'images');
    },
    filename: function (req, file, cb) {
        cb(null, uuidv4() + '-' + Date.now() + path.extname(file.originalname));
    }
});

2. 文件类型判断的MIME类型错误 #

fileFilter中允许的文件类型多了后缀s，正确的MIME类型是image/jpeg、image/png、image/jpg，而非images/xxx。同时，文件类型不合法时应传递错误对象，否则multer会静默失败：

// 错误写法
const fileFilter = (req, file, cb) => {
    const allowedFileTypes = ['images/jpeg', 'images/png', 'images/jpg'];
    if (allowedFileTypes.includes(file.mimetype)) {
        cb(null, true);
    }
    else {
        cb(null, false);
    }
}

// 正确写法
const fileFilter = (req, file, cb) => {
    const allowedFileTypes = ['image/jpeg', 'image/png', 'image/jpg'];
    if (allowedFileTypes.includes(file.mimetype)) {
        cb(null, true);
    }
    else {
        cb(new Error('仅允许上传JPEG、PNG、JPG格式的图片'), false);
    }
}

3. 未处理req.file为空的场景 #

如果请求中未上传photo字段，req.file会为null，此时访问req.file.filename会触发TypeError。需要添加判断逻辑：

// 在创建Voter实例前加入
if (!req.file) {
    return res.status(400).json({ message: '请上传头像照片' });
}

// 若允许用户不传照片，可设置默认值
const voter = new Voter({
    name: req.body.name,
    email: req.body.email,
    password: secPassword,
    cnic: req.body.cnic,
    constituency: req.body.constituency,
    pic: req.file ? req.file.filename : 'default-avatar.png'
})

额外调试配置 #

为了后续快速定位错误，建议添加全局错误处理中间件，在主服务文件（如app.js或server.js）末尾加入：

app.use((err, req, res, next) => {
    // 控制台打印错误栈，方便调试
    console.error(err.stack);
    // 开发环境返回详细错误信息，生产环境隐藏细节
    const errorInfo = process.env.NODE_ENV === 'development' ? err.message : '服务器内部错误';
    res.status(500).json({ 
        message: 'Internal Server Error',
        error: errorInfo
    });
});

其他排查点 #

• 确保项目根目录下存在images文件夹，multer不会自动创建目录，缺失会导致文件写入失败
• 测试请求时，确保Content-Type设置为multipart/form-data，这是文件上传必须的请求头
• 启动服务时设置开发环境变量：NODE_ENV=development node server.js，可获得更详细的错误日志

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