gRPC-web对接Go goproxy出现无错误信息的UNKNOWN gRPC错误如何解决

开发者阿泽

2026-9-30

问题修复方案

核心错误原因

你遇到的gRPC UNKNOWN(code=2)错误是服务端CORS配置和gRPC Web响应头处理错误导致的，服务端虽然正确生成了响应，但浏览器和gRPC Web客户端无法正确解析响应内容和状态。

具体修复步骤

1. 补充OPTIONS预检请求处理

浏览器跨域请求前会发送OPTIONS预检请求，你当前的逻辑没有单独处理该请求，会直接返回空响应导致预检失败。

2. 删除强制清空gRPC状态头的配置

你手动设置w.Header().Set("grpc-status", "")和w.Header().Set("grpc-message", "")会覆盖gRPC Web服务端自动生成的正确响应状态头，导致客户端无法识别请求结果。

3. 新增允许暴露的gRPC响应头配置

gRPC Web专用的响应头需要配置Access-Control-Expose-Headers，否则浏览器会禁止前端JS读取这些头信息，触发未知错误。

修复后的服务端Handler代码

httpServer := &http.Server{
    Handler: http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        // 统一处理CORS头
        w.Header().Set("Access-Control-Allow-Origin", "*")
        w.Header().Set("Access-Control-Allow-Methods", "POST, GET, OPTIONS, PUT, DELETE")
        w.Header().Set("Access-Control-Allow-Headers", "Accept, Content-Type, Content-Length, Accept-Encoding, X-CSRF-Token, Authorization, X-User-Agent, X-Grpc-Web")
        // 新增允许暴露gRPC专用响应头
        w.Header().Set("Access-Control-Expose-Headers", "grpc-status, grpc-message, grpc-encoding, grpc-accept-encoding")
        
        // 单独处理OPTIONS预检请求，直接返回204
        if r.Method == http.MethodOptions {
            w.WriteHeader(http.StatusNoContent)
            return
        }

        if r.ProtoMajor == 2 || grpcWebServer.IsGrpcWebRequest(r) {
            grpcWebServer.ServeHTTP(w, r)
            return
        }
        // 其他普通HTTP请求逻辑可在此补充
        http.NotFound(w, r)
    }),
}