OAuth2-proxy重定向至Django应用指定路径时出现404错误求助

核心原因 #

oauth2-proxy 的上游路径匹配逻辑是：当指定带路径的上游（如http://127.0.0.1:8000/hello），它会将客户端请求的路径直接追加到上游路径后。但认证完成后，oauth2-proxy 默认重定向到根路径/，此时实际转发给 Django 的请求会变成http://127.0.0.1:8000/hello/（带末尾斜杠），若 Django 的/hello路由未配置斜杠后缀支持，就会返回404；另外，oauth2-proxy 未正确将根路径映射到上游的/hello，也会导致请求转发异常。

解决方法 #

方法1：使用路径重写规则（精准匹配） #

修改上游配置，添加路径重写语法，明确将 oauth2-proxy 收到的根路径/映射到 Django 的/hello：

oauth2-proxy.exe ^
    --http-address=127.0.0.1:4180 ^
    --email-domain=* ^
    --cookie-secure=false ^
    --cookie-secret=adqeqpioqr809718 ^
    --upstream="http://127.0.0.1:8000/hello|/" ^
    --redirect-url=http://127.0.0.1:4180/oauth2/callback ^
    --oidc-issuer-url=http://127.0.0.1:28081/auth/realms/testrealm ^
    --insecure-oidc-allow-unverified-email=true ^
    --provider=keycloak-oidc ^
    --client-id=oauth2_proxy ^
    --ssl-insecure-skip-verify=true ^
    --client-secret=L2znXLhGX4N0j3nsZYxDKfdYpXHMGDkX ^
    --skip-provider-button=true 

语法说明：|/表示将当前服务的/路径重写为上游的/hello。如果需要让所有子路径都转发到/hello下，可改为--upstream="http://127.0.0.1:8000/hello|/*"。

方法2：调整 Django 路由兼容斜杠后缀 #

在 Django 的urls.py中，将路由改为path('hello/', views.your_view, name='hello')，并确保settings.py中APPEND_SLASH = True（默认开启），这样/hello和/hello/都会匹配到对应视图。

方法3：上游设为根路径+默认重定向（简单易用） #

保持上游为 Django 根路径，通过--default-redirect-url指定认证完成后直接跳转到/hello，这样所有路径转发逻辑正常，且用户认证后直接进入目标页面：

oauth2-proxy.exe ^
    --http-address=127.0.0.1:4180 ^
    --email-domain=* ^
    --cookie-secure=false ^
    --cookie-secret=adqeqpioqr809718 ^
    --upstream="http://127.0.0.1:8000" ^
    --default-redirect-url=http://127.0.0.1:4180/hello ^
    --redirect-url=http://127.0.0.1:4180/oauth2/callback ^
    --oidc-issuer-url=http://127.0.0.1:28081/auth/realms/testrealm ^
    --insecure-oidc-allow-unverified-email=true ^
    --provider=keycloak-oidc ^
    --client-id=oauth2_proxy ^
    --ssl-insecure-skip-verify=true ^
    --client-secret=L2znXLhGX4N0j3nsZYxDKfdYpXHMGDkX ^
    --skip-provider-button=true 

验证步骤 #

1. 重启 oauth2-proxy 使配置生效
2. 访问http://127.0.0.1:4180，完成认证后检查页面是否正常返回200
3. 查看 oauth2-proxy 日志，确认转发路径为http://127.0.0.1:8000/hello，同时 Django 日志能收到对应 GET 请求

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