Gin服务需显式绑定0.0.0.0:8080（或简写为":8080"）才能被局域网其他设备访问，而默认的127.0.0.1或localhost绑定仅限本机；同时须确保防火墙放行该端口并使用正确的局域网IP访问。
直接绑定 0.0.0.0 并显式指定端口，是 Gin 在局域网内被其他设备访问的必要条件；默认的 127.0.0.1 绑定只响应本机请求，这是绝大多数“局域网连不上”的根本原因。
启动时必须显式监听 0.0.0.0 而非 localhost
Gin 的 r.Run() 默认监听 127.0.0.1:8080，这在开发机上能 curl 通，但手机或另一台电脑 ping 不通、浏览器打不开。必须改成监听所有网络接口：
-
r.Run(":8080")是简写，实际等价于r.Run("0.0.0.0:8080")—— 这才是局域网可访问的关键 - 不要写成
r.Run("localhost:8080")或r.Run("127.0.0.1:8080")，它们效果相同，都拒绝外部连接 - 若端口被占用，错误提示是
listen tcp :8080: bind: address already in use，需先lsof -i :8080（macOS/Linux）或netstat -ano | findstr :8080（Windows）查杀进程
防火墙与系统网络策略常被忽略
即使代码绑定了 0.0.0.0，Linux/macOS 的防火墙或 Windows Defender 防火墙仍可能拦截入站连接：
- macOS：检查「系统设置 → 网络 → 防火墙」是否开启；若开启，需在「防火墙选项」中勾选「允许传入连接」并确认
go或终端进程被放行 - Linux（如 Ubuntu）：运行
sudo ufw status，若为 active，执行sudo ufw allow 8080 - Windows：打开「高级安全 Windows Defender 防火墙」→「入站规则」→ 新建规则 → 端口 → TCP 8080 → 允许连接 → 作用域设为「本地子网」
- 注意：公司/学校网络可能有统一网关策略，禁止非标准端口通信，此时换用
:80或:443也未必有效，需联系 IT 部门
调试时别依赖 gin.Default() 的默认中间件
gin.Default() 自动注入 Logger 和 Recovery，但在局域网调试阶段，这些中间件会掩盖真实问题：
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
-
Logger会刷屏输出所有请求日志，干扰快速定位连接失败原因；建议初期用gin.New()手动添加所需中间件 -
Recovery会捕获 panic 并返回 500，但若服务根本没起来（比如端口冲突），它根本没机会生效——此时应优先看启动日志里有没有Listening and serving HTTP on行 - 一个最小可用启动示例：
func main() { r := gin.New() r.GET("/", func(c *gin.Context) { c.String(200, "OK from %s", c.ClientIP()) }) r.Run(":8080") }启动后，在局域网另一台设备浏览器访问http://<你的电脑IP>:8080，看到 "OK from ..." 即表示通路已通
局域网 IP 获取与 DNS 无关，别折腾 hosts 或域名
局域网设备间通信靠的是 IPv4 地址（如 192.168.1.105），不是主机名或域名：
- 查本机局域网 IP：macOS/Linux 执行
ifconfig | grep "inet " | grep -v 127.0.0.1；Windows 执行ipconfig，找「无线局域网适配器 WLAN」或「以太网适配器 以太网」下的 IPv4 地址 - 不要试图在手机浏览器输
http://your-mac.local:8080或改/etc/hosts，mDNS（.local）在多数安卓/旧 iOS 上不支持，且增加一层不可靠抽象 - 如果路由器启用了 DHCP 保留，可将开发机 MAC 地址绑定固定 IP，避免每次重启后 IP 变更导致前端配置失效
真正卡住的地方，往往不是 Gin 本身，而是操作系统网络栈或物理网络隔离；确认 0.0.0.0 绑定、防火墙放行、IP 地址准确这三点后，90% 的局域网访问问题就解决了。
