如何基于反向代理请求头动态修改Symfony项目base_url

1. 调整NGINX反向代理规则 #

不要在反代时截断路径前缀，同时显式传递X-Forwarded-Prefix头给后端，Symfony原生支持识别该头作为路径根前缀。
正式环境后端配置示例：

location /api {
    # 禁止在proxy_pass末尾加斜杠，保留请求原始URI的前缀部分
    proxy_pass http://127.0.0.1:8000;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    # 显式声明当前路由前缀
    proxy_set_header X-Forwarded-Prefix "/api";
}

MR预览版后端动态配置示例：

location ~ ^/api/preview-mr(\d+)/ {
    set $mr_backend_port 8$1;
    proxy_pass http://127.0.0.1:$mr_backend_port;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    # 动态拼接当前MR版本的路径前缀
    proxy_set_header X-Forwarded-Prefix "/api/preview-mr$1/";
}

2. 配置Symfony信任反向代理头 #

Symfony默认不读取反向代理传递的Forwarded系列头，需要手动开启信任配置，修改config/packages/framework.yaml：

framework:
    # 其余已有配置保持不变
    trusted_proxies: '127.0.0.1,REMOTE_ADDR'
    trusted_headers: ['x-forwarded-for', 'x-forwarded-host', 'x-forwarded-proto', 'x-forwarded-prefix']

注意：不要硬编码framework.assets.base_path参数，硬编码固定值会导致MR预览场景无法匹配动态路径前缀。

3. 生效验证 #

执行命令清除Symfony缓存：

php bin/console cache:clear

配置生效后，Symfony的路由生成、asset静态资源路径、API Platform的文档及接口地址都会自动携带当前环境对应的路径前缀，不需要额外修改业务代码。

常见排错点 #

• 如果配置后仍不生效，检查public/index.php是否存在手动修改Request baseUrl的硬编码逻辑，这类自定义逻辑会覆盖Symfony对X-Forwarded-Prefix的自动解析。
• 本地开发如果使用Symfony内置服务器，不要添加--prefix启动参数，避免和反向代理传递的前缀冲突。

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