通过系统化的配置检查方案可预防大多数部署问题:
- 环境验证:使用
node -v确认 Node.js ≥18.0 - 密钥检查:确保
.env.local中所有配置项完整(重点检查 OAuth 回调 URL) - 权限确认:GitHub 账号对数据仓库有写入权限
分步排错指南:
- 登录失败:检查 GitHub OAuth App 的 Callback URL 必须包含完整路径
- 数据加载异常:手动创建空的
navigation.json文件初始化仓库 - 构建报错:删除
node_modules和 lockfile 后重新pnpm install
推荐在本地 pnpm dev 测试通过后再进行线上部署。
本答案来源于文章《NavSphere:使用GitHub仓库搭建的现代化个人导航网站》




























