现象
尝试将FastGPT挂载到主域名的子路径下访问，例如通过http://XXX.XXX/fastgpt访问时，页面内的相对路径资源（如/images/logo.svg）无法正确加载，出现资源404等报错。使用nginx代理配置无法有效解决该场景的访问需求，手动修改代码添加basePath配置后，仍存在大量相对路径引用的资源无法正确加载，且部分资源引用位置难以查找，伴随更多报错出现。
可能原因
FastGPT未内置上下文根配置项，内部静态资源与接口调用大量使用相对路径，未针对子路径部署场景做适配，导致直接通过子路径访问时资源路径解析错误，无法正确加载所需资源。
排查步骤
- 明确需要部署的子路径名称，例如fastgpt，记录该路径信息。
- 尝试配置nginx代理，将对应子路径的请求转发至FastGPT服务的根地址，验证访问时的资源加载与接口调用效果。
- 若代理配置无法解决访问异常，可尝试在代码中添加basePath相关配置，调整资源与接口的路径前缀，检查加载情况。
解决与验证
目前可通过手动修改代码添加basePath配置适配子路径部署，但需逐一修复所有相对路径引用的静态资源与接口调用，且部分资源引用位置难以查找，工作量较大。验证方式为通过指定子路径访问FastGPT，确认静态资源（如/images/logo.svg）与接口请求的路径均正确指向子路径下的对应地址，无404等报错。官方尚未提供内置的上下文根配置项，相关功能需等待项目后续更新支持。
来源： FastGPT 官方来源
适用性与版本范围
本页适用于官方来源记录的 故障排查 场景。执行变更前，需核对 FastGPT、依赖、API 与部署版本。
安全护栏
凭证与私密数据使用 [REDACTED_CREDENTIAL] 占位符。执行操作前需核对文档的环境与版本。
回滚指引
恢复变更前的技术内容权威快照、已保存配置与数据快照，再执行最小验证场景。