Docker部署集成OIDC插件的Kong对接Keycloak时出现Nginx配置无效问题

你的问题核心出在KONG_NGINX_PROXY_SET环境变量的配置语法上，错误日志已经明确指向nginx的set指令参数数量异常，这直接导致了Kong启动失败。

问题根源 #

nginx的set指令要求严格的格式：set $变量名 "带空格的变量值";。你当前的配置：

KONG_NGINX_PROXY_SET: '$session_secret amUgc8OpY3VyaKJIHGENldHRlIHJvdXRl'

会被nginx错误解析成两个独立参数：$session_secret和amUgc8OpY3VyaKJIHGENldHRlIHJvdXRl，这违反了set指令仅允许两个参数的语法规则，最终触发配置校验失败。

修复方案 #

你需要把变量值用双引号包裹，同时在YAML中正确转义，确保Kong传递给nginx的是一个完整的参数。修改docker-compose.yml中的对应环境变量：

KONG_NGINX_PROXY_SET: '"$session_secret amUgc8OpY3VyaKJIHGENldHRlIHJvdXRl"'

外层的双引号是YAML语法要求，用于保留内层的引号；这样nginx最终会收到正确的指令：set $session_secret "amUgc8OpY3VyaKJIHGENldHRlIHJvdXRl";

额外优化建议 #

1. 调整迁移服务依赖顺序：你的kong-migration服务同时依赖kong和kong-db，但迁移应该在Kong主容器启动前完成。建议把kong-migration的depends_on只保留kong-db，启动时先运行迁移命令，再启动Kong主容器。
2. 验证插件加载状态：修复配置后启动容器，查看日志确认kong-oidc插件是否正常加载，避免因插件安装不完整导致后续OIDC对接问题。

修改完成后重新启动容器，nginx配置错误的问题应该就能解决了。

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