> 本文整理自平台文档 docs/wujies/5.x/ruoyi-vue-plus/framework/association/update_url.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-6fe95b7b7f1c-cover.svg)
- - -
修改后端路径
修改 application.yml 的 server.servlet.context-path:

开发环境需要同步修改 vite.config.ts 的代理路径:

生产环境需修改 nginx.conf 后端代理路径:

补充说明:
- 当前前端开发代理默认是
VITE_APP_BASE_API='/dev-api',vite.config.ts会把这个前缀转发到http://localhost:8080。 - 如果后端
context-path从/改成了例如/admin-api,开发环境至少要同步调整代理目标或重写规则,否则请求会打不到新路径。 - 如果只是 Nginx 层做了反向代理前缀调整,但 Java 应用本身路径没变,则不一定需要改
context-path,重点是保持代理映射一致。
修改前端路径
3.4.0 提供便捷方式:修改 .env.* 中 VITE_APP_CONTEXT_PATH。
<br /> 
生产环境需要同步修改 nginx.conf。 注意:真实目录为 /usr/share/nginx/html/admin/index.html,多项目部署会增加一层目录,如不需要可自行调整。

补充说明:
- 当前项目路由基于
createWebHistory(import.meta.env.VITE_APP_CONTEXT_PATH)创建,Vite 打包base也同样读取这个变量。 - 因此前端访问路径调整时,不仅要改
.env.*,还要确认静态资源访问路径、Nginxlocation、刷新路由回退规则一起匹配。
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-6fe95b7b7f1c-guide.svg)


评论区需要浏览器启用 JavaScript 才能加载。