Buffalo 项目深度调试必须绕过 buffalo dev，改用 go run + dlv 直接调试 main.go，因其封装的子进程、多层代理导致断点失效、panic 堆栈被 recovery 中间件吞掉；推荐配置 VS Code launch.json 使用 "mode": "exec" 并显式传入环境变量。
Buffalo 项目调试不能只靠 buffalo dev 的日志输出，必须直连 Go 运行时——用 dlv 调试器 attach 到进程，或改用 go run 启动并配合断点，否则看不到 panic 原始栈、无法步进 handler 内部逻辑。
为什么 buffalo dev 不适合深度调试
它启动的是封装后的子进程，中间夹了 watcher、rebuild、log wrapper 多层代理。你设的断点基本不会命中，panic 也会被 Buffalo 的 recovery 中间件捕获并转成 500 页面，原始错误堆栈被吞掉。
常见现象包括：
- 在
actions/home.go里加log.Printf("here")能看到输出，但 Delve 断点不触发 - 访问页面返回空白或 500，终端只显示
Internal Server Error，没具体行号 - 修改代码后
buffalo dev自动重启，但调试会话已断开，得反复重连
用 go run + dlv 直接调试 main.go
这是最可控的方式：绕过 Buffalo CLI 的封装，让调试器直接控制 Go 进程生命周期。
操作步骤：
Buffalo框架 1.0.1
下载
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
- 确保项目已初始化模块：
go mod init myapp（模块名必须与import路径一致） - 在项目根目录运行：
dlv exec ./main.go --headless --api-version=2 --accept-multiclient --continue - 另开终端，用 VS Code 或 JetBrains GoLand 连接
dlv的调试端口（默认 2345），或直接用dlv connect :2345进入 CLI 调试模式 - 在
actions/app.go的App()函数开头、或具体 handler 里设断点，比如break actions/home.go:12
注意：main.go 必须调用 app.Serve()，且不能有 buffalo dev 相关的构建标记（如 //go:generate buffalo dev），否则 go run 会误触发 CLI 行为。
VS Code 中配置 launch.json 启动调试
在项目根目录的 .vscode/launch.json 中写入：
{
"version": "0.2.0",
"configurations": [
{
"name": "Debug Buffalo App",
"type": "go",
"request": "launch",
"mode": "exec",
"program": "${workspaceFolder}/main.go",
"env": {
"APP_ENV": "development",
"DATABASE_URL": "postgres://localhost/myapp_development?sslmode=disable"
},
"args": []
}
]
}
关键点：
-
"mode": "exec"表示直接执行 Go 源文件，不是编译后二进制，便于热更新和断点重载 -
env里显式传入环境变量，避免依赖.env文件加载失败导致数据库连接报错 - 不要勾选 “Auto-build before debug”，Buffalo 项目结构复杂，自动 build 容易触发 packr2 或 asset 编译冲突
调试中容易忽略的 Buffalo 特定问题
Buffalo 的中间件链、模板渲染、上下文传递都是隐式行为，断点打错位置就看不到关键数据：
- 想查请求参数？别在 handler 开头打断点，先确认是否经过
Bind()—— 在c.Param("id")或c.Request().URL.Query()处设断点更准 - 模板渲染失败？
c.Render()返回 error 会被吞，必须在调用后立刻检查：if err := c.Render(...); err != nil { log.Fatal(err) } - 数据库查询慢？
models.UserFindAll()底层是pop，断点要打在pop.Connection.Find()或 SQL 日志开启处（POP_DEBUG=true） - 自定义中间件不生效？确认是否在
App()中调用了app.Use(yourMiddleware)，而不是只写了函数定义
真正卡住的往往不是语法或逻辑，而是 Buffalo 的隐式生命周期管理——比如 buffalo.New() 初始化了模板引擎、中间件栈、路由树，这些对象在 app 实例里持有引用，调试时若跳过初始化直接跑 handler，context 会是 nil 或不完整。
