gin 的 c.redirect() 不自动补全子域名，必须手动拼接完整 url（如 https://api.example.com/path?query）；它仅执行 http 重定向，不解析 host 或推导子域名，所有跳转需显式指定协议、主机、路径和查询参数。
直接说结论：Gin 本身不解析 Host 或子域名，c.Redirect() 只能跳转到完整 URL（含协议、主机、路径），若要重定向到指定子域名（如 https://api.example.com），必须手动拼出目标 URL 字符串，不能靠框架自动推导。
为什么 c.Redirect() 不会自动补全子域名
Gin 的 c.Redirect() 是纯 HTTP 层操作，只接收状态码和目标 URL 字符串；它不读取原始请求的 Host 头做子域名替换，也不内置“当前域名 → 某子域名”的映射逻辑。所有子域名跳转都得显式写死或从 c.Request.Host 动态构造。
- 常见错误：写
c.Redirect(http.StatusMovedPermanently, "/path")—— 这会跳转到同域下的相对路径，不是子域名 - 开发时容易忽略 HTTPS 协议：若目标子域名只支持 HTTPS，但拼成了
http://api.example.com/...，浏览器可能被拦截或降级失败 - 硬编码子域名有维护风险：上线后换域名需改代码，建议提取为配置项（如环境变量）
如何安全拼出子域名跳转 URL
推荐用 c.Request.URL.Scheme + 显式子域名 + c.Request.URL.Path + c.Request.URL.RawQuery 组装，确保协议、路径、查询参数全部透传。
- 不要用
c.Request.Host直接替换，因为生产环境前可能有 Nginx、ALB 等代理，Host可能是负载均衡器地址而非客户端真实域名 - 若确定部署在直连公网场景，且子域名固定，可直接写死：
"https://api.example.com" + c.Request.URL.Path + "?" + c.Request.URL.RawQuery - 若需适配多环境（dev/staging/prod），建议从
os.Getenv("SUBDOMAIN_URL")读取，比如值设为https://api.example.com - 注意 URL 编码：路径和查询参数已由 Go 自动处理，无需额外
url.QueryEscape
实际跳转示例：/v1/* 路径强制跳到 api 子域名
假设所有以 /v1/ 开头的请求都要跳转到 https://api.example.com/v1/...，可这样写：
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
func redirectToSubdomain(c *gin.Context) {
subdomain := "https://api.example.com"
target := subdomain + c.Request.URL.Path
if c.Request.URL.RawQuery != "" {
target += "?" + c.Request.URL.RawQuery
}
c.Redirect(http.StatusMovedPermanently, target)
}
<p>r.GET("/v1/*any", redirectToSubdomain)</p>
- 用
/v1/*any通配符捕获所有子路径，比逐个注册路由更可靠 - 状态码选
http.StatusMovedPermanently（301）表示永久跳转，利于 SEO 和浏览器缓存 - 若只是临时调试，可用
http.StatusFound（302），避免本地缓存干扰
HTTPS 强制 + 子域名跳转的组合陷阱
如果既要跳子域名，又要确保走 HTTPS，别指望单个服务搞定——Gin 必须启动两个独立服务：一个 HTTP 端口做 301 跳转（含子域名 + HTTPS），另一个 HTTPS 端口提供真实服务。
- HTTP 服务里跳转逻辑必须包含完整目标 URL：
"https://api.example.com" + ...，不能只写"//api.example.com"（协议相对 URL 在现代浏览器中已被限制） - 证书必须覆盖子域名：若用通配符证书
*.example.com，则api.example.com有效；若只申请了example.com主域名证书，api.example.com会触发浏览器证书警告 - 私钥权限必须为
0600，否则r.RunTLS()静默失败，日志只报tls: private key does not match public key
真正麻烦的不是写几行跳转代码，而是确认子域名 DNS 解析、证书覆盖范围、以及前置代理是否已接管跳转逻辑——很多线上问题其实出在 Nginx 已经做了 301，Gin 又重复跳，导致循环重定向。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
