Unity上传文件到Node.js服务端报MulterError: Unexpected field错误如何解决?
错误原因
你遇到的报错核心是两个问题:
- Unity端
MultipartFormFileSection调用错误:你传入两个字符串参数时匹配的重载是MultipartFormFileSection(内容字符串, 字段名),相当于把字段名设为了文件路径的值,而非multer配置期望的file,导致multer找不到对应字段,抛出Unexpected field错误;同时你没有读取文件的实际二进制内容,只是把路径字符串当内容上传。 - 服务端上传接口没有返回响应,也缺少全局错误捕获逻辑,无法返回具体错误信息给前端。
修复方案
1. Unity端代码修改
using System.IO; using System.Collections; using System.Collections.Generic; using UnityEngine; using UnityEngine.Networking; public class FileUpload : MonoBehaviour { public string filePath; public void UploadProcess() { StartCoroutine(Upload()); } IEnumerator Upload() { // 先校验文件是否存在 if(!File.Exists(filePath)) { Debug.LogError("目标文件不存在:" + filePath); yield break; } // 读取文件二进制内容 byte[] fileContent = File.ReadAllBytes(filePath); // 提取原始文件名 string fileName = Path.GetFileName(filePath); List<IMultipartFormSection> formData = new List<IMultipartFormSection>(); // 使用正确重载:参数依次为 字段名、文件二进制、文件名、MIME类型 formData.Add(new MultipartFormFileSection("file", fileContent, fileName, "application/octet-stream")); UnityWebRequest www = UnityWebRequest.Post("http://localhost:3005/fileUpload", formData); yield return www.SendWebRequest(); if(www.isNetworkError || www.isHttpError) { // 打印服务端返回的错误详情,方便排查 Debug.LogError($"上传失败:{www.error},服务端返回:{www.downloadHandler.text}"); } else { Debug.Log("上传成功:" + www.downloadHandler.text); } // 释放请求资源 www.Dispose(); } }
2. 服务端代码修改
const express = require('express'); const multer = require('multer'); const fs = require('fs'); const path = require('path'); const app = express(); // 自动创建uploads目录,避免目录不存在导致的保存失败 const uploadDir = path.join(__dirname, 'uploads'); if (!fs.existsSync(uploadDir)) { fs.mkdirSync(uploadDir, { recursive: true }); } app.use(express.json()); app.use(express.static(uploadDir)); // 如果是WebGL端上传,需要开启跨域,放开下面两行注释 // const cors = require('cors'); // app.use(cors()); app.listen(3005, () => { console.log('服务已启动,端口3005'); }); const storage = multer.diskStorage({ destination: function(req, file, callback) { callback(null, uploadDir); }, filename: function(req, file, callback) { // 加时间戳避免同名文件覆盖,不需要可以删掉Date.now()+'_' callback(null, Date.now() + '_' + file.originalname); } }); const upload = multer({ storage : storage, // 限制单文件最大100M,可自行调整 limits: { fileSize: 1024 * 1024 * 100 } }); // 上传接口处理 app.post('/fileUpload', upload.single('file'), (req, res) => { if (!req.file) { return res.status(400).json({ code: 400, msg: '未接收到有效文件' }); } // 此处可添加你的业务逻辑,比如将文件路径存入数据库 res.json({ code: 200, msg: '上传成功', fileName: req.file.filename }); }); // 全局错误捕获中间件,返回明确错误信息 app.use((err, req, res, next) => { console.error('服务端错误:', err); if (err instanceof multer.MulterError) { return res.status(400).json({ code: 400, msg: '上传错误:' + err.message }); } res.status(500).json({ code: 500, msg: '服务端内部错误' }); });
排查建议
- 可以先用Postman等工具调用
http://localhost:3005/fileUpload接口上传文件,先确认服务端逻辑正常,再调试Unity端代码 - 如果是WebGL版本打包,需要在服务端开启跨域配置,同时注意WebGL的文件路径读取逻辑和原生平台有差异
- 上传失败时看Unity控制台打印的服务端返回内容,里面会有明确的错误原因
内容的提问来源于stack exchange,提问作者Minwoo Kim
相关产品推荐
相关产品推荐

