You need to enable JavaScript to run this app. Unity上传文件到Node.js服务端报MulterError: Unexpected field错误如何解决?
优惠活动
大模型
产品
解决方案
定价
更多

Unity上传文件到Node.js服务端报MulterError: Unexpected field错误如何解决?

错误原因

你遇到的报错核心是两个问题:

  1. Unity端MultipartFormFileSection调用错误:你传入两个字符串参数时匹配的重载是MultipartFormFileSection(内容字符串, 字段名),相当于把字段名设为了文件路径的值,而非multer配置期望的file,导致multer找不到对应字段,抛出Unexpected field错误;同时你没有读取文件的实际二进制内容,只是把路径字符串当内容上传。
  2. 服务端上传接口没有返回响应,也缺少全局错误捕获逻辑,无法返回具体错误信息给前端。
修复方案

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.09 04:54:02