S3 HEAD bucket 失败: 404 Not Found（CC Switch）

Quick fix

升级到 4.0 或最新版本后重试；旧版会在 endpoint 已含 bucket 名时再次拼接 bucket，导致请求路径错误。

Symptom

报错原文复制

S3 HEAD bucket 失败: 404 Not Found
(https://mybucket.oss-cn-zhongwei.aliyuncs.com/mybucket/)

Cause

在 CC Switch v3.18.0 中，`src-tauri/src/services/s3.rs` 的 `is_aws_endpoint` 只识别 `amazonaws.com`。阿里云 OSS 的 `aliyuncs.com` endpoint 因此进入 path-style 分支；当 endpoint 的 host 已以 `{bucket}.` 开头时，`build_bucket_url` 和 `build_object_url` 仍会在路径中追加 bucket，形成重复的 `/mybucket/`。

这会令 HEAD 请求返回 404；PUT 虽可能返回成功，却会把对象写入多出 bucket 名的错误前缀，之后 GET 无法按正确 key 读回。维护者表示 4.0 已对相关功能做较大重构并建议升级重试，但这些 issue 中没有提供升级后成功的确认结果。

Fix

1. 1

   将 CC Switch 更新到 4.0 或最新版本，然后使用相同的 S3 配置重新测试连接。

2. 2

   检查生成的请求 URL，确认 endpoint 的 host 已含 bucket 名时，路径中没有再次出现 `/mybucket/`。

3. 3

   重新执行上传和下载，并确认对象未被写入与 bucket 同名的额外前缀。

4. 4

   如果最新版本仍然失败，补充 CC Switch 版本、系统、完整复现步骤以及相关日志或截图，并重新打开 issue。

Affected Versions

ToolCC Switch

Version受影响版本：3.18.0；4.0 是否修复未在 issue 中确认

PlatformsLinux

Source Issues

本页汇总自 2 个真实 issue

• #5619S3 同步：自定义 endpoint 已含 bucket 名时 HEAD/PUT 路径重复拼接（OSS 等）；WebDAV：MKCOL 400 不被容错
• #5622S3 同步：自定义 endpoint 已含 bucket 名时 HEAD 失败 / 对象被存到错误前缀（OSS 等）

FAQ

（暂无 FAQ）

相关问题

settings.json 被 cc-switch把除 env 外的自定义配置（hooks、插件、spinnerVerbs 等）写进供应商的「通用配置」并勾选「写入通用配置」；官方不改为字段级合并。4 issues mergedClaude Code preference changes are升级到 v4.0.0；切换供应商时，Claude Code 的偏好设置会保留在 ~/.claude/settings.json 中。1 issues merged就是桌面端无法看到模型 Codex 桌面端登录官方 ChatGPT、开启「切换第三方时保留官方登录」并启用本地路由后，重启 Codex 桌面端查看模型。6 issues merged