SQLPage项目中使用连字符(-)作为站点前缀时的路径处理问题

问题描述

在SQLPage项目中，当开发者使用包含连字符(-)或下划线(_)的站点前缀(SQLPAGE_SITE_PREFIX)时，会遇到一个路径处理问题。具体表现为：

1. 首次访问基础URL时，系统会正确重定向到带有前缀的URL
2. 但直接访问带有前缀的URL时，会出现路径解析错误

问题重现

开发者可以通过以下步骤重现该问题：

1. 设置环境变量：

   SQLPAGE_SITE_PREFIX="/myapp-myapp-myapp" SQLPAGE_PORT=5006 SQLPAGE_HOST=10.10.11.248 sqlpage
   

2. 首次访问基础URL http://10.10.11.248:5006 时，会被308重定向到 http://10.10.11.248:5006/myapp-myapp-myapp/

3. 直接访问带有前缀的URL http://10.10.11.248:5006/myapp-myapp-myapp/ 时，会出现错误

错误详情

系统会返回如下错误信息：

An error occurred while trying to handle your request: Unable to get SQL file "/myapp-myapp-myapp/index.sql": Couldn't load "/myapp-myapp-myapp/index.sql" into cache: Unsupported path: "/myapp-myapp-myapp/index.sql". Path component 'RootDir' is not allowed.

临时解决方案

目前发现的一个临时解决方案是：在浏览器地址栏中使用URL编码的连字符(%2D)替代直接使用连字符(-)。例如：

http://10.10.11.248:5006/myapp%2Dmyapp%2Dmyapp/

技术背景

这个问题源于SQLPage对URL路径的解析逻辑。当路径中包含特殊字符时，系统未能正确处理路径组件，导致将整个前缀路径误认为是文件系统根目录(RootDir)，从而触发了安全限制。

项目维护者响应

SQLPage项目维护者已经确认了这个问题，并表示将在v0.31版本中修复。目前开发者可以使用最新的main分支构建版本来测试修复效果。

总结

这个问题展示了在Web应用开发中处理URL路径时需要特别注意的几个方面：

1. 特殊字符的处理：连字符、下划线等常见字符在URL中可能有特殊含义
2. 路径解析安全：防止路径遍历攻击的同时，需要确保合法路径能够正常访问
3. URL编码：理解浏览器和服务器之间URL编码/解码的交互过程

对于使用SQLPage的开发者，建议暂时避免在站点前缀中使用连字符，或者等待官方发布修复版本。