Go开发Web服务在树莓派3B+上http.HandleFunc绑定函数未执行问题

1. 前端WebSocket地址硬编码（最高发原因） #

• 你的index.html中大概率将WebSocket连接地址写死为ws://localhost:4444/data。本地运行时浏览器访问的是本地服务，localhost指向开发机，请求可以正常到达/data接口触发counter。部署到树莓派后，浏览器运行在访问设备上，localhost指向的是当前访问设备而非树莓派，根本不会向树莓派发起/data请求，counter自然不会执行。
• 解决方法：将前端WebSocket地址改为动态拼接当前访问域名，示例如下：

// 替换原硬编码的ws地址
const ws = new WebSocket(`ws://${window.location.host}/data`)

修改后无论服务部署到任何地址，前端都会自动拼接正确的服务地址发起请求。

2. 树莓派网络/端口限制 #

• 虽然你可以正常访问树莓派的首页，但可能存在防火墙规则限制4444端口的WebSocket请求，或者局域网路由隔离阻止了对应请求。
• 解决方法：
  • 先在树莓派本地执行curl http://localhost:4444/data，如果服务终端打印出connected，说明后端接口本身正常，问题出在前端或跨设备网络层面。
  • 检查树莓派防火墙配置，开放4444端口：如使用ufw防火墙可执行sudo ufw allow 4444。
  • 执行ss -tulnp | grep 4444确认你的Go服务已经正常监听4444端口。
  • 确认访问设备和树莓派在同一局域网，无路由规则限制WebSocket协议请求。

3. 交叉编译依赖异常 #

• 你当前的交叉编译命令未禁用CGO，如果依赖的websocket库或其他子包用到了CGO特性，本地编译默认开启CGO_ENABLED=1，生成的二进制依赖动态链接库，树莓派环境缺少对应依赖会导致接口运行异常。
• 解决方法：交叉编译时禁用CGO生成纯静态二进制，命令如下：

env CGO_ENABLED=0 GOOS=linux GOARCH=arm GOARM=7 go build .

编译完成后部署到树莓派运行，查看启动时是否有报错输出，排除运行时依赖缺失问题。

4. 静态文件路径错误 #

• 代码中使用相对路径template.ParseFiles("index.html")读取前端文件，如果部署时你在其他目录执行二进制，会导致读取不到正确的index.html，返回异常页面自然不会触发后续的WebSocket请求。
• 解决方法：部署时将index.html和编译好的二进制放在同一目录，执行二进制时也切换到该目录操作；也可以使用Go 1.16+的go:embed特性将静态文件嵌入二进制，避免路径依赖问题。

内容的提问来源于stack exchange，提问作者Lode Keppens