Mocha/Superagent文件上传测试报500错误求助：客户端调用正常

我之前也碰到过类似的问题，大概率是测试里的文件上传格式或者参数没跟客户端调用对齐导致的。给你几个靠谱的Mocha+Superagent文件上传测试示例，你可以对照着调整自己的代码：

单文件上传测试 #

先确保你已经安装了必要的依赖：superagent、mocha，Node.js内置的fs模块用来读取本地文件。如果后端用了multer这类表单解析中间件，测试端重点要构造符合要求的请求结构。

示例代码：

const request = require('superagent');
const fs = require('fs');
const assert = require('assert');

describe('文件上传接口测试', function() {
  it('应该成功上传单个文件', async function() {
    try {
      // 先确认测试文件存在，避免因文件不存在导致的异常
      const testFilePath = './test-files/sample.jpg';
      if (!fs.existsSync(testFilePath)) {
        throw new Error(`测试文件不存在：${testFilePath}`);
      }

      const response = await request
        .post('/api/upload') // 替换成你的实际上传接口路径
        .attach('file', testFilePath, 'sample.jpg') 
        // 三个参数分别是：后端接收的字段名、本地文件路径、可选的文件名（默认用路径中的文件名）
        .set('Content-Type', 'multipart/form-data') // 显式指定表单类型，避免自动识别出错
        // 如果接口需要鉴权，这里补充对应的请求头，比如：
        // .set('Authorization', 'Bearer ' + yourAuthToken)

      assert.strictEqual(response.status, 200);
      assert.ok(response.body.success, '上传状态应标记为成功');
      // 根据你的接口返回结构，添加更多断言逻辑
    } catch (err) {
      // 打印错误详情，方便排查500问题
      console.error('上传失败详情:', err.response?.body || err.message);
      throw err; // 让测试失败，同时保留完整错误信息
    }
  });
});

多文件上传测试 #

如果你的接口支持批量上传，只需要多次调用.attach()方法即可：

it('应该成功上传多个文件', async function() {
  const response = await request
    .post('/api/upload-multiple')
    .attach('files', './test-files/file1.png')
    .attach('files', './test-files/file2.txt')
    .set('Authorization', 'Bearer ' + yourAuthToken);

  assert.strictEqual(response.status, 200);
  assert.equal(response.body.uploadedCount, 2); // 假设接口返回成功上传的文件数量
});

排查500错误的关键要点 #

• 确认后端接收的字段名和测试里.attach()的第一个参数完全一致（比如后端用req.files.file，那字段名必须是file）
• 检查本地文件路径是否正确，测试时要保证文件确实存在
• 对比客户端请求和测试请求的请求头，特别是鉴权信息、Content-Type这类关键头有没有遗漏
• 查看后端的错误日志，500通常是后端抛出的异常，日志里会直接给出问题原因（比如文件大小超限、不允许的文件类型等）

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