go-shiori项目子路径部署时eventBus.js路径错误问题分析

在go-shiori项目的1.7.0版本中，当用户通过Nginx等反向代理将Shiori服务部署在子路径(如/shiori)下时，系统会出现一个前端资源加载路径错误的问题。这个问题主要影响eventBus.js文件的加载，导致前端功能可能无法正常工作。

问题现象

当Shiori服务被部署在子路径下时，前端页面中的大部分资源都能正确加载，但eventBus.js文件的引用路径却出现了问题。从页面源代码可以看到，其他资源都使用了正确的相对路径"./assets/..."，而eventBus.js却使用了错误的"../assets/..."路径。

这种路径差异会导致浏览器尝试从错误的URL位置加载eventBus.js文件，最终导致404错误，进而可能影响前端功能的正常运行。

技术分析

这个问题本质上是一个前端资源路径配置问题。在单页应用(SPA)中，当应用被部署在子路径下时，所有资源引用都需要考虑基础路径(base path)的影响。

在go-shiori项目中，大部分前端资源引用都正确处理了子路径部署的情况，但eventBus.js的引用路径却意外地使用了"../"前缀，这会导致：

1. 当应用部署在根路径时，可能不会出现问题
2. 但当部署在子路径(如/shiori)下时，浏览器会尝试从/shiori/../assets/...加载资源，这实际上等价于/assets/...，跳出了应用的基础路径

解决方案

目前有两种可行的解决方案：

1. 临时解决方案：使用Nginx的sub_filter模块重写路径 在Nginx配置中添加以下规则，可以临时修复这个问题：

   sub_filter ../assets/js/component/eventBus.js ./assets/js/component/eventBus.js;
   

2. 根本解决方案：修复前端代码中的路径引用 项目维护者应该在源代码中修正eventBus.js的引用路径，确保它与其他资源使用相同的路径引用方式。这需要修改前端模板或构建配置，确保生成的HTML中使用正确的相对路径。

影响范围

这个问题主要影响：

• 使用Nginx等反向代理部署的用户
• 将Shiori服务部署在子路径下的场景
• 版本1.7.0的用户

对于直接部署在根路径或使用不同版本的用户，可能不会遇到这个问题。

最佳实践建议

对于Web应用开发，特别是需要支持子路径部署的应用，建议：

1. 统一使用绝对路径或基于基础路径的相对路径
2. 在前端构建过程中考虑部署环境的基础路径
3. 提供配置选项让用户可以指定部署的基础路径
4. 在开发环境中模拟子路径部署场景进行测试

通过遵循这些实践，可以避免类似的路径问题，提高应用在不同部署环境下的兼容性。