Multer接收FormData时文件后追加的普通表单字段丢失如何解决

核心原因 #

Multer 对 multipart/form-data 格式的请求是按顺序流式解析的：

• 所有在文件字段之前追加的普通文本字段，会在解析文件前完成挂载到req.body
• 所有在文件字段之后追加的普通文本字段，需要等文件完全解析完成后才会挂载到req.body

你的代码在 Multer 的 fileFilter 回调中直接读取req.body做业务校验，这个执行时机刚好是 Multer 解析到文件字段的阶段，只有文件字段之前的普通字段被解析完成，文件字段后追加的seminarDate、totalVideo等字段还没被处理，自然读取不到。如果校验逻辑在此时因为字段缺失提前终止请求，后续的字段永远不会被解析挂载。

这个问题和Multer的字段数量上限无关，Multer本身没有默认的普通字段数量限制。 #

修复方案 #

方案1：调整前端字段追加顺序 #

所有普通文本字段全部放在文件字段之前追加，最后再append文件类型的字段即可，调整后代码示例：

export const submitClass = ({ classData }) => {
    return async (dispatch) => {
        try {
            const { userAccessToken } = getToken()
            const formData = new FormData()
            // 先追加所有普通文本字段
            formData.append("idUser", classData.idUser)
            formData.append("certificationName", classData.certificationName)
            formData.append("classAdvantages", JSON.stringify(classData.classAdvantages))
            formData.append("classDescription", classData.classDescription)
            formData.append("classFeePercentage", classData.classFeePercentage)
            formData.append("classLevel", classData.classLevel)
            formData.append("classPrice", classData.classPrice)
            formData.append("classSlug", classData.classSlug)
            formData.append("classURLTrailer", classData.classURLTrailer)
            formData.append("classname", classData.classname)
            formData.append("isFree", classData.isFree)
            formData.append("isLive", classData.isLive)
            formData.append("seminarDate", classData.seminarDate)
            formData.append("totalVideo", classData.totalVideo)
            // 最后追加文件字段
            formData.append("poster", classData.poster.posterFile)
            const response = await axios.post(endpoint.SUBMIT_CLASS, formData, {
                headers: {
                    'Content-Type': 'multipart/form-data',
                    Authorization: `Bearer ${userAccessToken}`
                }
            })
            const { msg: message } = response.data
            import(`helpers/toast`).then(({ successToast }) => {
                successToast(message)
            })
        } catch (error) {
            if (error.response) {
                const { msg: errorMessage, errLevel } = error.response.data
                if (errLevel > 1) import(`helpers/toast`).then(({ errorToast }) => {
                    errorToast(errorMessage)
                })
            }

        }
    }
}

方案2：调整后端校验逻辑 #

不建议在fileFilter中做普通业务参数校验，将普通字段的校验逻辑移到后续的submitClassValidation中间件中处理，此时Multer已经完成所有字段（包括文件前后的普通字段）的解析，req.body是完整的，不会出现字段丢失问题。

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