Kong Go-PDK插件配置企业代理功能失效如何排查解决？

问题排查与修复方案 #

核心问题定位 #

1. 嵌套字段赋值方式错误
   Lua支持直接操作ngx.ctx.balancer_address这个嵌套表的字段，但Go PDK的kong.Nginx.SetCtx不支持用点分隔的字符串作为key访问嵌套字段。你当前的写法实际是在ngx.ctx下创建了两个顶级key：balancer_address.host和balancer_address.port，和Lua示例中修改balancer_address结构体内部字段的效果完全不同。
2. 端口参数类型错误
   balancer_address.port要求是数字类型，你传入的是字符串"8080"，弱类型的Lua可以自动转换，但Go PDK会校验类型，直接赋值失败，你打了错误日志但没有查看相关输出，所以没有感知到这个报错。
3. 容器网络访问问题
   你配置的代理地址是127.0.0.1:8080，这个地址指向的是Kong容器自身的环回地址，而非宿主机上部署的代理服务，容器默认网络模式下无法直接访问宿主机的环回端口。
4. 版本不兼容问题
   你的构建镜像用的是kong/go-plugin-tool:2.0.4，对应Kong 2.0.x版本，但运行镜像用的是kong:2.3-alpine，PDK接口版本不匹配会导致SetCtx等方法调用失效。
5. 插件优先级问题
   如果你的插件优先级低于Kong内置的路由、负载均衡插件，那么你修改balancer_address的时候，负载均衡逻辑已经执行完毕，修改自然不会生效。

具体修复步骤 #

1. 修正插件代码

package main

import (
    "github.com/Kong/go-pdk"
)

type Config struct {
    Apikey string
}

func New() interface{} {
    return &Config{}
}

func (conf Config) Access(kong *pdk.PDK) {
    // 更稳妥的方式：直接调用PDK方法设置上游目标，不需要操作ctx
    err := kong.Service.SetTarget("host.docker.internal", 8080)
    if err != nil {
        kong.Log.Err("set proxy target failed: ", err.Error())
        return
    }

    // 后续权限校验逻辑
    key, err := kong.Request.GetQueryArg("key")
    apiKey := conf.Apikey

    if err != nil {
        kong.Log.Err("get query arg failed: ", err.Error())
    }

    x := make(map[string][]string)
    x["Content-Type"] = append(x["Content-Type"], "application/json")

    if apiKey != key {
        kong.Response.Exit(403, "You have no correct key", x)
    }
}

如果一定要通过修改balancer_address实现，用以下写法替代直接赋值点分隔key的逻辑：

// 先取出完整的balancer_address结构体
balancerAddr, err := kong.Nginx.GetCtx("balancer_address")
if err != nil {
    kong.Log.Err("get balancer address failed: ", err.Error())
    return
}
// 断言类型后修改内部字段
if addr, ok := balancerAddr.(map[string]interface{}); ok {
    addr["host"] = "host.docker.internal" // 宿主机代理地址，Linux下换宿主机局域网IP
    addr["port"] = 8080 // 传数字类型，不要加引号
    // 把修改后的结构体写回ctx
    err = kong.Nginx.SetCtx("balancer_address", addr)
    if err != nil {
        kong.Log.Err("set balancer address failed: ", err.Error())
        return
    }
}

2. 对齐版本与调整Docker配置

• 修改构建镜像的基础镜像tag为和运行镜像一致的2.3版本：FROM kong/go-plugin-tool:2.3.0-alpine-latest AS builder
• 启动容器时如果是Linux系统，加上--net=host参数使用宿主机网络，避免跨网络访问问题；如果是Mac/Windows系统，直接用代码里的host.docker.internal即可访问宿主机端口。

3. 日志排查

启动容器时增加环境变量-e "KONG_LOG_LEVEL=debug"，查看容器日志：

• 确认没有插件相关的报错
• 确认你打印的日志正常输出，代码走到了设置代理的逻辑
• 确认权限校验逻辑没有提前返回403，导致转发逻辑未执行

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