先确认ngrok绑定端口是否与本地Webhook服务端口一致，如服务在8080则需ngrok http 8080；再检查Go服务是否注册了根路径处理器、Host头处理及Content-Length策略；最后确保ngrok配置文件层级正确、进程持久化启动。
ngrok 启动后 Webhook 收不到请求？先查 ngrok http 是否绑定了正确端口
本地 Webhook 服务跑在 localhost:8080，但用 ngrok http 3000 启动，请求自然进不来——端口对不上是最常见的“收不到”原因。ngrok 不会自动探测你的服务端口，它只把流量转发到你明确指定的本地地址。
实操建议：
- 确认 Webhook 服务真实监听地址，比如
netstat -an | grep 8080或看启动日志里的Listening on :8080 - 用
ngrok http 8080（不是服务名、不是路径、就是数字端口） - 如果服务绑定了
127.0.0.1:8080而非0.0.0.0:8080，某些 ngrok 版本可能因 loopback 检查失败而静默丢包；加--host-header=rewrite强制透传（见下一条）
Go 服务返回 400 或连接被重置？检查 Host 头和 http.ServeMux 路由匹配
ngrok 生成的域名（如 abc123.ngrok.io）会作为 Host 头发给你的 Go 服务。如果你用 http.ServeMux 做路由，且没注册根路径 / 或对应路径，Go 的默认行为是返回 400 Bad Request —— 它认为这个 Host 不受信任，或路径未注册。
常见错误现象：curl 看到 400 Bad Request，但本地 curl localhost:8080 正常；日志里没有 handler 被调用痕迹。
立即学习“go语言免费学习笔记（深入）”；
实操建议：
- 确保至少有一个 handler 注册在
http.HandleFunc("/", ...)，哪怕只是http.NotFound，避免默认 400 - 如果依赖
Host做多租户分发，别直接用req.Host，改用req.Header.Get("X-Forwarded-Host")（ngrok 会带这个头） - Go 1.22+ 默认启用
http.Server{StrictContentLength: true}，若 Webhook 请求体没带Content-Length或用了Transfer-Encoding: chunked，可能被拒；加StrictContentLength: false临时绕过（仅调试）
为什么 ngrok start --config ngrok.yml 配置文件总不生效？注意 tunnels 和 authtoken 的层级
ngrok 的 YAML 配置对缩进和字段位置极其敏感。把 authtoken 写在 tunnels 下面、或者漏了 tunnels: 顶层 key，都会导致配置加载失败，退回到无配置状态——此时它可能用旧 token 或报错但不提示。
典型错误配置：
authtoken: 2Kf...ZxQ
tunnels:
webhook:
proto: http
addr: 8080
正确写法必须是：
tunnels:
webhook:
proto: http
addr: 8080
authtoken: 2Kf...ZxQ
实操建议：
- 运行
ngrok start --config ngrok.yml --log=stdout看控制台是否打印reading config from和tunnel 'webhook' started - 配置中避免使用 tab 缩进，全用空格（YAML 规范要求）
- 如果用免费版 ngrok，
authtoken是必需的；没配会导致隧道创建失败，但错误信息藏在日志深处，容易误判为网络问题
Go 程序热重载时 ngrok 连接中断？别用 go run 直接启服务
go run main.go 启动的服务进程生命周期短，一旦代码保存触发热重载（比如用 air 或 fresh），原进程退出，ngrok 就断开连接，新进程启动后不会自动重连——你得手动重启 ngrok。
这不是 ngrok 的问题，而是进程管理错位。Webhook 调试期间频繁改代码，这种中断会浪费大量等待时间。
实操建议：
- 开发阶段用
go build -o server && ./server启动二进制，再配个简单的文件监听脚本（如inotifywait+kill %1; ./server &），比依赖 go run 更可控 - 如果坚持热重载，选支持 “exec command on change” 的工具（如
air的cmd配置项），让它 kill 并重启的是你的 server 进程，而不是整个 shell - ngrok 本身不提供重连机制；它的隧道是长连接，一旦本地服务进程消失，隧道就进入 “disconnected” 状态，不会等你重启
内网穿透不是黑盒，ngrok 只负责转发，Go 服务怎么起、怎么认请求、怎么响应，每一步都得自己对齐。最容易被忽略的，其实是 http.Server 的默认行为和 ngrok 的头透传规则之间那几行配置差异。
