Go作为FastCGI服务端如何从Request对象获取DOCUMENT_ROOT等参数

解决方案 #

这两个参数属于FastCGI协议的自定义环境变量，不属于HTTP标准请求字段，因此net/http.Request结构体默认不会直接暴露，你可以按照以下步骤获取： #

步骤1：确认NGINX透传配置

首先确认你的NGINX站点配置中已经正确添加了这两个参数的透传规则，示例配置如下：

location ~ \.go$ {
    fastcgi_pass unix:/run/your-go-fcgi.sock;
    include fastcgi_params;
    # 必须显式配置这两行，确保参数透传
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    fastcgi_param DOCUMENT_ROOT $document_root;
}

即使你觉得配置没问题也建议二次核对，大部分拿不到参数的情况都是配置漏写或者优先级不对导致的。 #

步骤2：Go侧从FCGI上下文取值

标准库net/http/fcgi会把所有透传的FCGI参数放在请求上下文里，通过fcgi.RequestKey即可取出对应参数：

package main

import (
	"net/http"
	"net/http/fcgi"
)

func main() {
	http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
		// 从上下文取出FCGI请求对象
		fcgiReq, ok := r.Context().Value(fcgi.RequestKey).(*fcgi.Request)
		if !ok {
			http.Error(w, "不支持的请求模式", http.StatusInternalServerError)
			return
		}

		// 直接读取你需要的两个参数
		scriptFilename := fcgiReq.Params["SCRIPT_FILENAME"]
		documentRoot := fcgiReq.Params["DOCUMENT_ROOT"]

		// 业务逻辑示例：输出参数
		w.Write([]byte("SCRIPT_FILENAME: " + scriptFilename + "\n"))
		w.Write([]byte("DOCUMENT_ROOT: " + documentRoot + "\n"))
	})

	// 启动FCGI服务监听Unix套接字
	err := fcgi.ServeListener(yourUnixListener, nil)
	if err != nil {
		panic(err)
	}
}

补充说明

• 如果你的Go服务同时需要支持直接HTTP访问和FCGI模式，仅FCGI模式下能拿到这两个参数，直接HTTP访问时不会有对应值。
• 所有你列出来的FCGI透传参数（包括SSL相关、客户端IP端口等非HTTP标准字段）都可以通过fcgiReq.Params这个map直接读取。

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