TechNotesKnowledge BaseRSS
常见错误排查 封面
Vapor 大型教程

常见错误排查

Vapor 的错误常常不是代码本身：缓存、生成文件、依赖版本和配置都可能影响结果。遇到编译或启动异常时，按清理、重建、核对配置的顺序排查。

排错

使用 Xcode 开发时，如果找不到文件或者项目配置出错时尝试重新生成 Xcode 项目：

vapor clean --swiftpm && vapor xcode

完全找不到错误原因时尝试全部清理重新编译运行：

  1. Xcode 中使用 Cmd+Shift+K 清空编译产物
  2. 清空编译中间产物： 
    vapor clean
  3. 清空所有产物： 
    vapor clean --update --global --swiftpm
    或者 
    vapor clean -u -g -s

求助他人

Vapor 在 Discord Channel 上有频道可以求助。但 Discord 在中国完全被墙掉了，这也对于 Vapor 的流行起到了一定的阻碍作用。如果有访问国际互联网的手段，翻墙后可以下载 Discord，并进入频道。

按顺序定位问题

  1. 先看终端中第一条错误，而不是最后一条连带错误；记录完整的文件名、行号和 Swift 版本。
  2. 确认依赖与环境：执行 swift --version、vapor --version，再检查 Package.swift 的依赖版本。
  3. 用最小改动复现：暂时撤掉最近加入的路由、中间件或迁移，确认问题属于编译、启动还是请求阶段。
  4. 如果是运行时 500，查看服务器日志和请求路径；不要把“页面打不开”直接当成网络问题。
记录结果：排错时把“现象、复现命令、根因、修复方式”写进项目 README 或 issue。下一次升级 Swift 或依赖时，这些记录比单纯的清理命令更有价值。

本系列其他文章