PortalJS项目中自定义域名下Wikilinks链接异常问题解析

在PortalJS项目中，用户报告了一个关于自定义域名下Wikilinks链接异常的技术问题。本文将深入分析该问题的现象、原因及解决方案。

问题现象 当用户在自定义域名（如wiki.secondrenaissance.net）上使用Wikilinks功能时，生成的链接中会错误地插入用户名和组织信息。例如，原本期望生成的链接格式应为域名/页面名称，但实际生成的链接却变成了域名/@用户名/组织名称/页面名称。

技术分析 这种链接生成异常属于路由配置问题。在自定义域名场景下，系统错误地沿用了多租户模式下的URL生成逻辑，导致在路径中冗余添加了用户和组织信息。这种设计在单租户的自定义域名部署中是不必要且错误的。

解决方案 开发团队通过修改路由生成逻辑修复了该问题。新的实现会判断当前部署模式，在自定义域名场景下生成简洁的标准URL格式。这需要：

1. 正确识别部署环境类型
2. 根据环境类型应用不同的URL生成策略
3. 确保向后兼容性

最佳实践建议 对于使用PortalJS搭建知识库的用户，建议：

1. 在自定义域名部署时检查链接生成逻辑
2. 定期更新到最新版本以获取修复
3. 测试所有内部链接以确保功能正常

该修复体现了PortalJS项目对用户体验的持续优化，特别是在自定义部署场景下的完善。开发者应当注意不同部署模式下的功能差异，确保系统在各种环境下都能提供一致的用户体验。