Kong代理服务器新增location块转发请求至S3不生效如何解决

可以在Kong代理的server块内新增自定义location规则，但直接修改运行时生成的nginx-kong.conf、以及你当前写的配置存在多处错误，导致请求无法转发到S3。

配置失效的核心原因 #

• 配置修改方式错误：Kong每次重启、重载配置时，都会根据内置模板重新生成nginx-kong.conf，直接手动修改这个文件的内容，重载后会被直接覆盖，配置根本不会生效。
• Location匹配优先级不足：Kong默认的location /块内置了大量正则匹配规则、请求处理逻辑，普通前缀匹配location /test-abc的优先级低于正则匹配，请求会先被location /捕获进入Kong处理流程，不会走到你写的S3转发逻辑里。
• 语法错误：你配置里的proxy_pass <s3-url-here>行尾缺少分号，Nginx解析配置时会直接报错，该段配置不会被加载。
• 必要配置缺失：转发到S3没有配置Host重写、SSL SNI等必填参数，就算匹配到location，也会被S3侧拒绝访问返回403/404。

可落地的实现方案 #

方案1：通过Kong配置注入自定义规则（推荐，无额外组件） #

不要修改自动生成的运行时配置，在Kong的主配置文件kong.conf中，找到nginx_proxy_server_conf配置项，把自定义location规则写在这个配置项里，规则会被自动注入到Kong代理server块的最前端，重载后不会被覆盖。
注意location必须加^~前缀修饰符（如果是精确匹配路径可以用=修饰符，优先级更高），确保匹配优先级高于Kong内置的正则规则，参考配置如下：

# 写入kong.conf的nginx_proxy_server_conf字段
location ^~ /test-abc {
    # 注意行尾必须加分号，S3地址末尾建议加/，避免路径拼接异常
    proxy_pass https://你的S3桶访问地址/;
    # 转发S3必须携带正确的Host头，否则会触发S3访问权限校验失败
    proxy_set_header Host 你的S3桶对应访问域名;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_ssl_server_name on;
    # 自定义响应头
    add_header  'content-type' 'application/json';
    add_header  'cache-control' 'public, max-age=0';
    add_header  'vary' 'Accept-Encoding';
    add_header  'accept-ranges' 'bytes';
    charset UTF-8;
    default_type application/json;
}

修改完成后执行kong reload重载配置即可生效，后续重启Kong规则也不会丢失。

方案2：前置代理层分流（易维护，无配置侵入） #

如果不想修改Kong的内置配置逻辑，可以在Kong前端部署一层Nginx/OpenResty作为入口，在入口层做路径分流：

• 路径匹配/test-abc的请求直接转发到S3
• 其余所有请求统一转发到Kong的代理端口
  这种方案自定义分流逻辑和Kong完全解耦，后续升级Kong版本、修改Kong配置都不会影响分流规则，适合生产环境使用。

注意：所有自定义Nginx规则都要通过Kong的配置注入项、或者自定义Nginx模板实现，不要直接修改运行时自动生成的配置文件，否则配置必然在重载/重启后丢失。

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