From d577ad28c60cca50b631677b132fc5d537eb75af Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=96=AF=E7=8B=82=E7=9A=84=E7=8B=AE=E5=AD=90Li?=
 <15040126243@163.com>
Date: Fri, 4 Sep 2026 14:34:42 +0800
Subject: [PATCH] =?UTF-8?q?fix=20=E4=BF=AE=E5=A4=8D=20=E4=BA=91oss=20cdn?=
 =?UTF-8?q?=E5=9F=9F=E5=90=8D=E4=BD=BF=E7=94=A8=E9=97=AE=E9=A2=98?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../common/oss/config/OssClientConfig.java    | 28 ++++++++++++++++++-
 1 file changed, 27 insertions(+), 1 deletion(-)

diff --git a/ruoyi-common/ruoyi-common-oss/src/main/java/org/dromara/common/oss/config/OssClientConfig.java b/ruoyi-common/ruoyi-common-oss/src/main/java/org/dromara/common/oss/config/OssClientConfig.java
index eb0076822..7bc2475bb 100644
--- a/ruoyi-common/ruoyi-common-oss/src/main/java/org/dromara/common/oss/config/OssClientConfig.java
+++ b/ruoyi-common/ruoyi-common-oss/src/main/java/org/dromara/common/oss/config/OssClientConfig.java
@@ -220,11 +220,37 @@ public class OssClientConfig implements Config<OssClientConfig, OssClientConfig.
      * @return 桶URL地址
      */
     public String getBucketUrl(String bucket) {
-        String url = getAccessBaseUrl();
+        // 云厂商的自定义域名通常是桶绑定的 CDN/映射域名，域名本身已经包含桶信息，不能再拼接桶名。
+        // 自定义域名仅对默认桶生效；其它桶仍使用访问站点生成标准 S3 地址。
+        if (!usePathStyleAccess && isDefaultBucket(bucket) && hasCustomDomain()) {
+            return getDomainUrl();
+        }
+        String url = (!usePathStyleAccess && hasCustomDomain() && !isDefaultBucket(bucket))
+            ? getEndpoint()
+            : getAccessBaseUrl();
         // 根据是否使用路径风格配置项决定存储桶的URL风格
         return usePathStyleAccess ? BucketUrlUtil.getPathStyleBucketUrl(useHttps, url, bucket) : BucketUrlUtil.getSiteStyleBucketUrl(useHttps, url, bucket);
     }
 
+    /**
+     * 判断是否配置了自定义域名。
+     *
+     * @return 是否配置了非空自定义域名
+     */
+    private boolean hasCustomDomain() {
+        return domain().filter(StringUtils::isNotBlank).isPresent();
+    }
+
+    /**
+     * 判断指定桶是否为当前客户端配置的默认桶。
+     *
+     * @param bucket 存储桶名称
+     * @return 是否为默认桶
+     */
+    private boolean isDefaultBucket(String bucket) {
+        return bucket().filter(defaultBucket -> defaultBucket.equals(bucket)).isPresent();
+    }
+
     /**
      * 解析 S3 Region。
      *