应用放到子路径后页面能开、资源404:核对基础路径与代理转发
把应用从网站根目录移到https://www.example.com/app/后,首页能显示却没有样式、登录跳到根目录,通常要同时核对代理路径和应用的基础地址。仅让首页返回200,不能证明子路径部署已经完成。
一、先确认应用是否支持子路径
查看当前应用版本的部署说明,找到基础URL、公共路径或前缀设置。某些应用只支持独立域名;这种情况下,给它分配单独子域名比不断改写HTML更容易维护。
在浏览器“网络”面板看失败资源的完整URL:它请求的是/app/assets/main.css,还是错误地请求/assets/main.css?再看登录后的Location和Cookie的Path。记录这些具体差异,不要先加一组全局rewrite。
二、决定上游要看到哪一种路径
下面两种Nginx写法选一种,不能放在同一站点同时使用。适用于普通前缀location和本机HTTP上游;正则location、变量proxy_pass或已有rewrite需要另行分析。
| 外部请求 | 上游实际接受的路径 | 选择 |
|---|---|---|
| /app/login | /login | 转发时移去/app/前缀。 |
| /app/login | /app/login | 保留原始路径。 |
上游从根路径提供服务时:
location /app/ {
proxy_pass http://127.0.0.1:3000/;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto $scheme;
}
上游自己已经处理/app/前缀时:
location /app/ {
proxy_pass http://127.0.0.1:3000;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto $scheme;
}
区别是proxy_pass端口后有没有路径斜杠,不是排版差异。示例中的地址和端口须与真实上游一致;若由容器或面板管理代理,使用该环境实际加载的配置。
三、让应用生成正确的外部地址
按应用本身的配置机制设置外部基础地址为https://www.example.com/app/,必要时重新构建前端资源。应用收到代理头时,只信任自己管理的代理来源。单加一个X-Forwarded-Prefix头,不会让所有软件自动理解子路径。
检查登录跳转、表单提交地址、静态资源和WebSocket入口是否带正确前缀。Cookie的Path也要符合应用实际范围;不要随意扩大到根目录,使不同应用产生同名Cookie冲突。应用本身能够配置时,优先使用其支持的方式。
以上以斜杠结尾且使用proxy_pass的前缀location,会把不带末尾斜杠的/app自动重定向为/app/,默认状态为301,可能使POST被客户端改为GET。API应直接使用正确的最终路径;确需兼容/app时,应另行设计精确location并验证方法和请求体,不能只复制这两段就当作已经处理。已有静态资源正则location也可能抢走/app/下的请求,应核对实际匹配,不凭猜测一直加规则。
四、按完整路径验证并保留回退
- 备份本次配置,先验证Nginx语法,成功后再加载。
- 对照上游访问日志,确认它收到的路径与预期一致。
- 用新的浏览器窗口依次验证首页、深层页面刷新、CSS/JS、登录、退出和无副作用表单。
- 确认链接和跳转始终留在预期地址;同域名下其他应用仍能正常使用。
若只有首页正常,继续处理失败资源及生成地址,不把错误全部回退到首页伪装成200。回退时恢复代理配置和本次应用基础地址改动。