Go应用+Nginx反向代理路径重定向问题求助

我之前也遇到过一模一样的问题！当用Nginx把Go应用挂载在子路径（比如/myapp）下时，Gorilla Mux生成的重定向总是跳去根路径，根源其实是Go应用不知道自己的「上下文前缀」——也就是你设置的/myapp。下面是我亲测有效的解决步骤：

1. 让Go应用感知子路径前缀 #

Gorilla Mux本身不会自动从反向代理请求中获取子路径，所以我们需要主动告诉它这个前缀，最灵活的方式是通过环境变量或者请求头传递：

方式一：用环境变量固定前缀 #

可以在Docker启动时传入环境变量（比如APP_BASE_PATH=/myapp），然后在代码中用这个前缀包裹所有路由：

package main

import (
    "net/http"
    "os"

    "github.com/gorilla/mux"
)

func main() {
    // 从环境变量获取子路径，默认根路径
    basePath := os.Getenv("APP_BASE_PATH")
    if basePath == "" {
        basePath = "/"
    }

    r := mux.NewRouter()
    // 用PathPrefix创建子路由器，所有路由都基于这个前缀
    subRouter := r.PathPrefix(basePath).Subrouter()

    // 注册你的路由，注意路径不需要再带basePath
    subRouter.HandleFunc("/something", func(w http.ResponseWriter, r *http.Request) {
        // 重定向时一定要带上basePath，不要硬编码根路径！
        http.Redirect(w, r, basePath+"/another", http.StatusFound)
    })

    subRouter.HandleFunc("/another", func(w http.ResponseWriter, r *http.Request) {
        w.Write([]byte("Hello from /myapp/another!"))
    })

    http.ListenAndServe(":8080", r)
}

方式二：从Nginx请求头动态获取前缀 #

如果同一个Go镜像需要部署在不同子路径下，可以让Nginx传递X-Forwarded-Prefix头，然后在Go代码中读取：

func getBasePath(r *http.Request) string {
    // 从Nginx设置的请求头获取前缀
    prefix := r.Header.Get("X-Forwarded-Prefix")
    if prefix != "" {
        return prefix
    }
    // fallback到根路径
    return "/"
}

func main() {
    r := mux.NewRouter()

    http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
        basePath := getBasePath(r)
        subRouter := r.PathPrefix(basePath).Subrouter()
        
        // 注册路由...
        subRouter.HandleFunc("/something", func(w http.ResponseWriter, r *http.Request) {
            http.Redirect(w, r, basePath+"/another", http.StatusFound)
        })
    })

    http.ListenAndServe(":8080", r)
}

2. 配置Nginx正确传递路径和头部 #

Nginx这边的配置也很关键，必须确保把完整的子路径传递给Go应用，并且设置必要的请求头：

server {
    listen 80;
    server_name localhost;

    location /myapp/ {
        # 注意proxy_pass末尾的/，这会让Nginx把/myapp/xxx转发到http://go-app:8080/myapp/xxx
        proxy_pass http://go-app:8080/myapp/;
        # 传递Host头，让Go应用知道域名
        proxy_set_header Host $host;
        # 传递真实IP（可选）
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        # 传递子路径前缀给Go应用（对应方式二的代码）
        proxy_set_header X-Forwarded-Prefix /myapp;
    }
}

⚠️ 注意：proxy_pass后面的路径如果带了结尾的/，Nginx会保留子路径前缀转发；如果不带，会把/myapp替换为空，这就是导致重定向丢失前缀的常见原因！

3. 排查重定向的坑点 #

• 不要在代码中硬编码重定向路径（比如http.Redirect(w, r, "/another", ...)），必须拼接basePath
• 如果使用Gorilla Mux的RedirectHandler，也要确保目标路径包含basePath
• 测试时可以用curl -v http://localhost/myapp/something查看重定向响应头，确认Location是否包含/myapp前缀

这样配置后，访问localhost/myapp/something就会正确重定向到localhost/myapp/another了！

内容的提问来源于stack exchange，提问作者tamasfe