禁用middleware.recovery并改用go run main.go启动，才能看到真实panic堆栈；同时在app()函数return前加app.precompiletemplates()，使模板路径错误在启动时暴露而非运行时panic。

Buffalo 项目调试不能只靠 buffalo dev 启动后看浏览器——它会吞掉 panic 堆栈、屏蔽原始错误上下文、跳过模板预编译校验，导致你花半小时找一个拼错的 r.HTML("admin.dashboard") 路径。

禁用 Recovery 中间件才能看到真实 panic

默认 middleware.Recovery 会捕获所有 panic 并返回 500 页面，但原始错误（比如 http.Post: context deadline exceeded）完全丢失。

• 在 app.go 中注释掉这行：app.Use(middleware.Recovery)
• 改用 go run main.go 启动，绕过 buffalo dev 的日志封装层
• 若必须保留 Recovery，可在 handler 开头加兜底 recover：

  defer func() {
      if r := recover(); r != nil {
          log.Printf("PANIC: %v\n%v", r, debug.Stack())
      }
  }()

• 注意：不要在 buffalo dev 下依赖终端输出的 panic 日志——它被截断过，不完整

启动时强制预编译模板，提前暴露路径错误

r.HTML("users/show") 找不到文件是开发期最高频 panic，但它只在用户访问时触发。你应该让它在启动阶段就失败。

Buffalo框架 1.0.1

Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。

下载

• 在 app.go 的 App() 函数里、return app 之前插入：app.PrecompileTemplates()
• 确保拼写全小写：users/show.html ≠ Users/Show.html
• 路径必须用点号分隔：r.HTML("users.show") → 对应 templates/users/show.html；r.HTML("users/show.html") 必然失败
• 如果 buffalo dev 启动没报错，说明 app.PrecompileTemplates() 没执行到——检查是否被 if 分支跳过，或写在了 return 之后

Session 数据丢失或读取为空的调试要点

开发环境里 c.Session().Set("key", val) 看似成功，但刷新后取不到，大概率不是代码问题，而是中间件或配置缺失。

• 确认 app.Use(session.Middleware()) 已启用——没有它，c.Session() 返回空对象，Set 静默失败
• c.Session().Set() 后必须调用 c.Session().Save()，否则 Cookie 不下发，浏览器收不到 Set-Cookie 头
• 检查 config/session.yml 中 secret 是否为空或太短——签名失败会导致 Save() 返回 500
• 开发时 secure: true 会让浏览器拒绝保存 Cookie（因非 HTTPS），需设为 false
• 读取时别直接断言：v, ok := c.Session().Get("key").(string)，ok 为 false 时要处理 fallback

编辑器里 import 标红、跳转失效怎么办

VS Code 或 GoLand 显示大量红色波浪线，不是插件问题，而是 Go 模块未正确初始化或路径不匹配。

• 进项目根目录运行：go mod graph | head -n 5，若报 no go.mod found，立即执行：go mod init your-module-name（模块名必须与 import 路径一致，比如 github.com/yourname/myapp）
• 接着运行：go mod tidy，拉取依赖并生成 go.sum
• VS Code 中确保已安装 Go 扩展，并在 .vscode/settings.json 里启用 "go.useLanguageServer": true
• GoLand 导入时选 “Go module” 方式，不要选 “GOPATH”，右键项目名 → “Reload project” 强制刷新索引
• 删掉 vendor/ 和 go.work（如有），它们会干扰模块解析

真正卡住调试的，往往不是语法或逻辑错误，而是 Buffalo 的约定机制没对齐：模板路径大小写、Session Save 调用遗漏、模块名与 import 不一致、Recovery 中间件掩盖堆栈——这些点不手动验证，光刷新浏览器毫无意义。