K8s部署Bitnami WordPress子路径下管理面板URL缺失路径前缀问题

问题成因 #

该问题的核心是WordPress后台前端逻辑和反向代理路径重写的上下文不匹配：

• 你配置的WP_HOME和WP_SITEURL仅对服务端渲染的静态链接（如前台文章链接、页面内嵌入资源链接）生效，而WordPress后台的大部分导航跳转、地址栏更新逻辑由前端JS实现，JS会基于服务端拿到的REQUEST_URI生成路由基准路径。
• 你的Nginx Ingress将/wordpress/xxx重写为/xxx传给后端WordPress服务，WordPress内部获取到的请求路径没有/wordpress前缀，返回给前端的路由基准配置也不带前缀，导致JS直接基于站点根路径拼接后台路由，出现路径丢失前缀的问题。
• 没有30x跳转是因为整个路径修改过程都是前端JS在本地执行的，没有触发服务端跳转。

解决方法 #

按以下两步调整配置即可修复：

1. 调整Ingress配置，传递路径前缀给后端 #

在现有Ingress的annotations中新增两条配置，确保后端能拿到真实的访问前缀：

annotations:
  kubernetes.io/ingress.class: nginx
  nginx.ingress.kubernetes.io/custom-http-errors: '404'
  nginx.ingress.kubernetes.io/rewrite-target: /$2
  # 新增以下两条配置
  nginx.ingress.kubernetes.io/use-regex: "true"
  nginx.ingress.kubernetes.io/configuration-snippet: |
    proxy_set_header X-Forwarded-Prefix "/wordpress";

2. 补充WordPress配置，修复请求上下文 #

在wp-config.php中原有WP_HOME、WP_SITEURL配置下方新增以下逻辑，让WordPress感知到真实的请求前缀：

define( 'WP_HOME', 'http://example.com/wordpress/' );
define( 'WP_SITEURL', 'http://example.com/wordpress/' );
// 新增以下配置
if (isset($_SERVER['HTTP_X_FORWARDED_PREFIX'])) {
    $_SERVER['REQUEST_URI'] = $_SERVER['HTTP_X_FORWARDED_PREFIX'] . $_SERVER['REQUEST_URI'];
}

如果你是通过Helm Chart部署的Bitnami WordPress，不需要手动修改容器内的wp-config.php，直接在values.yaml的wordpressExtraConfig字段中添加上述配置即可，避免容器重启后配置丢失：

wordpressExtraConfig: |
  define( 'WP_HOME', 'http://example.com/wordpress/' );
  define( 'WP_SITEURL', 'http://example.com/wordpress/' );
  if (isset($_SERVER['HTTP_X_FORWARDED_PREFIX'])) {
      $_SERVER['REQUEST_URI'] = $_SERVER['HTTP_X_FORWARDED_PREFIX'] . $_SERVER['REQUEST_URI'];
  }

配置完成后重新应用Ingress资源、更新WordPress部署，清空浏览器缓存后再访问后台，路径前缀就会正常保留，跳转也不会出现404问题。

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