本文介绍一种轻量、高效的方式，使用 Go 标准库 net.DialTimeout 检测指定主机和端口是否可建立 TCP 连接，并返回布尔值结果，适用于健康检查、服务发现等场景。
本文介绍一种轻量、高效的方式，使用 go 标准库 `net.dialtimeout` 检测指定主机和端口是否可建立 tcp 连接，并返回布尔值结果，适用于健康检查、服务发现等场景。
在 Go 中，判断一个服务（如 example.com:8080）是否“在线”，最直接有效的方法并非发送 HTTP 请求（需解析协议、处理重定向、超时逻辑复杂），而是尝试建立底层 TCP 连接——即执行一次 TCP 握手探测。只要目标地址的端口处于监听状态且网络可达，net.DialTimeout 就能成功返回连接；否则返回错误。这种方式开销极小、响应迅速，且不依赖应用层协议。
以下是一个简洁、健壮的封装函数，返回 bool 表示可达性，并支持自定义超时：
package main
import (
"log"
"net"
"time"
)
// IsReachable 检测 host:port 是否可建立 TCP 连接
// 示例：IsReachable("google.com:443", 2*time.Second) → true
func IsReachable(addr string, timeout time.Duration) bool {
conn, err := net.DialTimeout("tcp", addr, timeout)
if err != nil {
return false
}
conn.Close() // 立即关闭连接，避免资源泄漏
return true
}
func main() {
host := "httpbin.org:80"
if IsReachable(host, 3*time.Second) {
log.Printf("✅ %s is reachable", host)
} else {
log.Printf("❌ %s is unreachable", host)
}
}⚠️ 注意事项：
- 仅检测 TCP 层连通性：该方法无法验证服务是否真正“健康”（例如 Web 服务返回 503），仅确认端口监听且网络可达；
- DNS 解析包含在超时内：若域名解析慢或失败，也会触发超时或返回错误；
-
避免空指针/panic：务必检查
err，不可忽略；连接成功后必须调用conn.Close()； -
不适用于 UDP 或其他协议：如需 UDP 探测，应使用
net.DialTimeout("udp", ...)，但语义不同（UDP 无连接建立过程）； - 生产环境建议加日志上下文与重试机制：单次探测可能受瞬时网络抖动影响，关键服务可结合少量重试（如 2～3 次）提升可靠性。
总结：对于“某主机某端口是否存活”这一常见需求，net.DialTimeout("tcp", addr, timeout) 是 Go 中最简单、标准、零依赖的解决方案。它精准对应网络层可达性，代码简短、性能优异，是构建运维工具、健康检查模块的理想起点。
