使用预签名URL向Minio上传文件时出现MissingFields错误的求助

我来帮你排查这个在Node.js + Minio环境下使用预签名URL上传文件时遇到的MissingFields错误，咱们一步步定位问题：

最常见的原因：请求方法错误 #

你生成的是PutObjectCommand对应的预签名URL，这意味着必须使用PUT请求方法，而不是POST。很多人会不小心在Postman里选成POST，这就会触发MissingFields错误——因为POST方式上传S3/Minio需要特定的表单字段，而你的预签名URL是为PUT设计的，不需要这些字段。

👉 解决：在Postman里把请求方法改成PUT，Body选择「binary」并选中你的图片文件，不要添加任何表单参数。

检查Key的一致性 #

从错误信息里看到目标Key是records/marbles.jpg，但你代码里设置的Key是marbles.jpg，两者不匹配。这种不一致也会导致服务端校验失败。

👉 解决：确保生成预签名URL时的bucketParams.Key和你期望上传的目标路径完全一致。比如如果要传到records/marbles.jpg，代码里应该改成：

const bucketParams = {
  Bucket: 'myBucket',
  Key: `records/marbles.jpg`,
};

优化预签名URL的生成代码 #

为了避免潜在的签名不匹配问题，建议在生成PutObjectCommand时明确指定文件的Content-Type（和你上传的文件类型一致），这样签名会更准确：

import { getSignedUrl } from '@aws-sdk/s3-request-presigner';
import { PutObjectCommand, S3Client } from '@aws-sdk/client-s3';

const s3Client = new S3Client({
  region: 'us-east-1',
  credentials: {
    accessKeyId: 'minioadmin',
    secretAccessKey: 'minioadmin',
  },
  endpoint: 'http://172.21.0.2:9000',
  forcePathStyle: true,
});

// 明确指定Key和Content-Type
const bucketParams = {
  Bucket: 'myBucket',
  Key: `records/marbles.jpg`, // 和错误信息里的Key保持一致
  ContentType: 'image/jpeg', // 根据你的图片类型调整，比如png就是image/png
};

const command = new PutObjectCommand(bucketParams);
const signedUrl = await getSignedUrl(s3Client, command, { expiresIn: 10000 });

额外校验点 #

• 确认Minio服务正常运行，http://172.21.0.2:9000可访问，且myBucket已经创建。
• 复制预签名URL到Postman时，不要修改URL里的任何参数，确保签名的完整性。
• 不要在Postman的Headers里手动添加多余的字段（比如Content-Type），除非你在生成签名时已经指定了该字段（此时要保持一致）。

先按照上面的步骤排查，尤其是请求方法和Key一致性这两点，大多数情况下都能解决这个问题。

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