MinIO 默认预签名 URL 有效期为 1 秒至 7 天，若需长期可用的公开访问链接，不能依赖 getPresignedObjectUrl 的默认行为；正确做法是显式设置 expiry() 参数，并理解其安全边界与替代方案。
minio 默认预签名 url 有效期为 1 秒至 7 天，若需长期可用的公开访问链接，不能依赖 `getpresignedobjecturl` 的默认行为；正确做法是显式设置 `expiry()` 参数，并理解其安全边界与替代方案。
在 MinIO Java SDK 中，getPresignedObjectUrl() 生成的是临时授权访问链接，其核心设计原则是“最小权限、有限时效”。默认情况下，未指定过期时间时，SDK 会自动设为 7 天（604800 秒），这正是您遇到链接 7 天后失效的根本原因。
✅ 正确设置自定义过期时间
您需要在构建 GetPresignedObjectUrlArgs 时，显式调用 .expiry(int seconds) 方法。例如：
// 示例：设置有效期为 30 天（2592000 秒）
String url = minioClient.getPresignedObjectUrl(
GetPresignedObjectUrlArgs.builder()
.method(Method.GET)
.bucket(bucketName)
.object(uuid + "-" + multipartFile.getOriginalFilename())
.expiry(2592000) // ⚠️ 注意：单位为秒，最大支持 7 天（604800）——见下文说明
.build()
);⚠️ 重要限制说明：
MinIO 服务端（包括官方 Docker 镜像及 Free Tier）硬性限制预签名 URL 最长有效期为 7 天（604800 秒）。即使您传入 Integer.MAX_VALUE 或 -1，服务端仍会截断并返回 400 Bad Request 或静默降级为 7 天（取决于 MinIO 版本）。该限制由 server 配置项 MINIO_EXPIRY_MAX_DAYS=7 控制，免费版/单机版无法绕过。
? 验证方式：启动 MinIO 时添加环境变量 MINIO_EXPIRY_MAX_DAYS=30 并重启服务（仅限自托管且有配置权限场景），但此操作不适用于 MinIO SaaS、托管服务或无 root 权限的部署环境。
✅ 真正“永久可用”的推荐方案（生产级）
既然预签名 URL 本质是临时凭证，追求“永久有效”违背其安全模型。更合理、可持续的实践是：
-
启用公共读取策略（Bucket Policy）
若文件无需鉴权，直接对 Bucket 设置 public-read 策略，使对象可通过 https://your-minio-host/bucket-name/object-key 直接访问：{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": "*", "Action": ["s3:GetObject"], "Resource": ["arn:aws:s3:::your-bucket/*"] } ] }✅ 优点：零过期、零签名开销、CDN 友好
⚠️ 注意：确保敏感数据不落入该 Bucket 按需动态生成短期 URL（推荐）
不在数据库中持久化 URL，而是在前端请求时实时调用 getPresignedObjectUrl(...).expiry(3600)（如 1 小时），既保障安全性，又避免链接泄露风险。代理层中转（增强可控性）
通过应用网关（如 Spring Boot Controller）接收请求 → 校验权限 → 后端调用 MinIO getObject() 流式转发。URL 永久有效，权限逻辑完全自主。
? 总结与建议
| 方案 | 是否“永久” | 安全性 | 实施难度 | 适用场景 |
|---|---|---|---|---|
| expiry(604800)（7 天） | ❌ 有上限 | 中 | 低 | 临时分享、内部测试 |
| Bucket Public Policy | ✅ 是 | 低（需严格分类） | 中 | 静态资源（图片、JS、CSS） |
| 动态生成短时效 URL | ✅ 逻辑永久 | 高 | 中 | 用户文件下载、邮件附件 |
| 应用层代理转发 | ✅ 是 | 最高 | 高 | 敏感文档、权限精细化控制 |
? 关键提醒：永远不要将长期有效的预签名 URL 存入数据库或日志——它等同于暴露临时密钥。真正的“永久访问”，应通过基础设施权限配置或业务层动态授权实现，而非对抗 SDK 的安全设计。
如您使用的是 MinIO 托管服务（如 Cloudflare R2 兼容层、AWS S3），请查阅对应平台文档——其预签名策略可能不同，但“7 天硬上限”在开源 MinIO v3+ 中是统一行为。
