Minio预签名URL浏览器无法使用，出现SignatureDoesNotMatch错误

一、SignatureDoesNotMatch错误排查 #

针对浏览器打开预签名URL出现的签名不匹配问题，可从以下几点排查：

• URL编码不一致：浏览器会自动对URL中的特殊字符（如空格、中文、特殊符号）进行编码，但预签名是基于原始字符串生成的。如果tId或task变量包含特殊字符，签名时的原始路径和浏览器请求的编码后路径不匹配，就会触发错误。解决方法：生成URL时对object路径进行URL编码，确保签名和请求使用一致的路径格式。
• 请求参数篡改：预签名URL包含了response-content-type参数，浏览器请求时如果该参数被修改（比如被插件或浏览器自动调整），会导致签名验证失败。可以尝试去掉该额外参数测试，或者确保浏览器请求时严格带上该参数。
• 服务器与客户端时间不同步：Minio预签名URL的有效性依赖时间戳，如果本地机器和Minio服务器时间差过大（超过15分钟），签名会被判定无效。同步客户端和服务器的系统时间即可。

二、上传文件无名称问题修复 #

你的代码生成的是GET方法的预签名URL，这是用于下载对象的，并非上传用途。要实现文件上传，需调整请求方法并补充文件名：

1. 单文件上传（PUT方法） #

修改请求方法为Method.PUT，同时在object参数中加入具体文件名，确保上传后文件以指定名称存储：

Map<String, String> reqParams = new HashMap<>();
reqParams.put("response-content-type", "application/json");
String minioUploadUrl = "";

try {
    minioUploadUrl = minioPrimaryClient.getPresignedObjectUrl(
            GetPresignedObjectUrlArgs.builder()
                    .method(Method.PUT) // 改为PUT方法用于上传
                    .bucket(org)
                    .object(tId + "/" + task + "/" + "your-file-name.ext") // 补充具体文件名
                    .expiry(60 * 60)
                    .extraQueryParams(reqParams)
                    .build());
} catch (Exception e) {
    throw new RuntimeException(e);
}
return minioUploadUrl;

使用该URL时，通过PUT请求上传文件内容，Minio会按指定路径和文件名存储文件。

2. 多文件上传（POST表单方法） #

如果需要批量上传多个文件，建议使用Minio的表单上传预签名，通过POST请求提交表单：

try {
    PostPolicy policy = new PostPolicy(org, ZonedDateTime.now().plusHours(1));
    // 设置允许上传的两级文件夹前缀
    policy.addStartsWithCondition("key", tId + "/" + task + "/");
    // 生成表单上传所需的参数
    Map<String, String> formData = minioPrimaryClient.getPostFormData(policy);
    
    // 前端可借助该formData构建表单，上传多个文件时，为每个文件的key字段设置完整路径+文件名（如tId/task/file1.jpg）
} catch (Exception e) {
    throw new RuntimeException(e);
}

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