Lychee相册系统子域名安装路径重定向问题解析

问题背景

Lychee相册系统在最新版本中出现了一个关于子域名安装路径重定向的问题。当用户访问基础URL时，系统本应自动重定向到/gallery路径，但实际上却显示空白页面。这一问题主要影响使用子域名安装Lychee的用户体验。

技术分析

该问题源于系统对旧版V4重定向逻辑的处理存在缺陷。具体表现为：

1. 当LEGACY_V4_REDIRECT设置为true时，系统无法正确处理基础URL到/gallery的重定向
2. 访问带有哈希参数的URL(如/gallery#albumID)时，系统仍会显示首页而非相册内容
3. 重定向过程中会出现短暂的白屏现象

解决方案

开发团队通过以下方式解决了这一问题：

1. 修复了重定向脚本逻辑，确保正确处理各种URL情况
2. 优化了内容安全策略(CSP)配置，添加必要的哈希值以支持重定向脚本执行
3. 对重定向过程中的白屏现象进行了说明，这是必要的技术实现细节

技术实现细节

重定向机制的核心在于一个JavaScript脚本，它会解析URL中的哈希参数，并根据不同情况跳转到正确的路径：

const hashMatch = document.location.hash.replace("#", "").split("/");
const albumID = hashMatch[0] ?? '';
const photoID = hashMatch[1] ?? '';
if (photoID !== '') {
    window.location = '/gallery/' + albumID + '/' + photoID;
} else if (albumID !== '') {
    window.location = '/gallery/' + albumID;
} else {
    window.location = '/gallery';
}

用户建议

对于遇到此问题的用户，可以采取以下措施：

1. 确保使用最新版本的Lychee系统
2. 检查LEGACY_V4_REDIRECT设置是否符合需求
3. 验证CSP配置是否包含必要的脚本哈希值
4. 理解短暂白屏是重定向过程中的正常现象

总结

Lychee团队快速响应并解决了这一影响用户体验的重定向问题，体现了对系统稳定性和兼容性的重视。通过这次修复，用户在使用子域名安装Lychee时将获得更加流畅的访问体验。