Golang后端CORS配置无效，远程访问出现跨域错误

核心问题定位 #

你遇到的根本问题不是CORS配置错误，而是前端代码硬编码了localhost:8181作为后端API地址。当远程用户访问http://161.35.yy.xxx:80时，浏览器会尝试请求用户本地的8181端口（而非服务器的8181端口），导致ERR_CONNECTION_REFUSED，同时触发浏览器的私有地址空间安全限制（非安全上下文下禁止访问本地地址）。

分步解决方案 #

1. 修正前端API请求地址

把前端代码中所有http://localhost:8181的请求地址，替换为服务器公网IP+后端端口，比如：

// 原错误写法
fetch('http://localhost:8181/free-riding/duckduckgo.com')

// 修改后写法
fetch('http://161.35.yy.xxx:8181/free-riding/duckduckgo.com')

更灵活的方案是动态获取当前页面的IP作为后端地址前缀：

const backendBaseUrl = `${window.location.protocol}//${window.location.hostname}:8181`;
fetch(`${backendBaseUrl}/free-riding/duckduckgo.com`)

2. 完善fasthttp的CORS配置

仅设置Access-Control-Allow-Origin不足以处理完整的CORS场景，需要添加预检请求（OPTIONS）处理及必要的响应头：

// CORS中间件
func corsMiddleware(next fasthttp.RequestHandler) fasthttp.RequestHandler {
    return func(ctx *fasthttp.RequestCtx) {
        // 允许前端的实际源地址，替换为你的前端访问地址
        allowedOrigin := "http://161.35.yy.xxx:80"
        ctx.Response.Header.Set("Access-Control-Allow-Origin", allowedOrigin)
        ctx.Response.Header.Set("Access-Control-Allow-Methods", "GET, POST, OPTIONS")
        ctx.Response.Header.Set("Access-Control-Allow-Headers", "Content-Type")
        // 如果需要传递Cookie，添加此行
        // ctx.Response.Header.Set("Access-Control-Allow-Credentials", "true")

        // 处理OPTIONS预检请求
        if ctx.IsOptions() {
            ctx.Response.SetStatusCode(fasthttp.StatusOK)
            return
        }

        // 执行后续请求处理
        next(ctx)
    }
}

// 使用中间件包裹你的路由处理函数
func main() {
    handler := corsMiddleware(func(ctx *fasthttp.RequestCtx) {
        // 你的业务逻辑处理
        ctx.WriteString("Hello World")
    })

    fasthttp.ListenAndServe(":8181", handler)
}

注意：如果需要传递Cookie，不要用*作为Access-Control-Allow-Origin的值，必须指定具体的源地址。

3. 验证服务器配置

• 确认Docker端口映射正确：后端容器的8181端口已映射到主机的8181端口（启动命令包含-p 8181:8181）
• 检查服务器防火墙/安全组，确保80和8181端口允许外部访问

关于浏览器私有地址错误的说明 #

The request client is not a secure context and the resource is in more-private address space local 这个错误是浏览器的安全限制：非HTTPS的页面（非安全上下文）禁止请求localhost等私有地址。修正后端请求地址为服务器公网IP后，这个错误会自动消失。

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