Documentation
README
存储 URL 策略选择规范
当使用 MinIO/OSS/S3 等对象存储时,正确选择 URL 生成策略。
陷阱 #1: 头像等长期资源使用预签名 URL
场景: 头像、Logo、商品图等需要长期访问的资源
问题根因
预签名 URL 有时效限制(MinIO/S3 最大 7 天),头像等长期资源会过期导致无法访问。
错误示例
// ❌ 错误: 预签名 URL 最大 7 天,头像会过期
String avatarUrl = minioService.getPresignedUrl(filePath, 60 * 24 * 365);
// IllegalArgumentException: expiry must be minimum 1 second to maximum 7 days
// ❌ 错误: 即使设置 7 天,头像也会在 7 天后失效
String avatarUrl = minioService.getPresignedUrl(filePath, 60 * 24 * 7);
// 7 天后用户头像显示"图片加载失败"
正确做法
This is the opening of the README. Read the full README on GitHub.