Aerospike官方Go客户端（v6.8.0+）开箱即用，支持6.x集群、TLS、认证与自动重连；须显式设ClientPolicy.Timeout≥3000ms防初始化失败，高频写优先用PutBins()而非Put()，复用Key实例并监控client.Stats()定位连接池瓶颈。
直接用官方 Go 客户端 aerospike-client-go 即可，它已支持 Aerospike 6.x 集群协议、TLS、认证、自动重连和连接池，不是“能用”，而是“开箱即用的生产级选择”。别自己封装裸 socket 或硬套 REST API。
确认客户端版本与服务端兼容性
Aerospike 服务端 6.0+ 默认启用 tls-name 和更严格的认证握手，而老版本客户端（如 v5.x）会因 TLS SNI 或 auth-mode 不匹配直接报 Invalid node response 或静默断连。必须用 v6.8.0+ 的 aerospike-client-go。
- 检查当前依赖：
go list -m github.com/aerospike/aerospike-client-go，低于 v6.8.0 就升级 - 升级命令：
go get github.com/aerospike/aerospike-client-go@v6.8.0 - 若服务端启用了
auth-mode tls（而非internal），客户端必须显式配置TLSConfig，且证书 CN 必须匹配节点 IP 或 DNS 名（不能只靠 SAN）
初始化 client 时绕过常见超时陷阱
默认 NewClientWithPolicy 使用 BasePolicy.Timeout = 1000ms，但首次连接集群元数据同步可能耗时 2–3s（尤其跨机房或 SSD 负载高时），导致 Client.ConnectTimeout 触发后整个 client 初始化失败，后续所有请求都 panic。
- 显式设置连接超时：
client, err := aerospike.NewClientWithPolicy(&aerospike.ClientPolicy{Timeout: 3000}, "10.10.10.10", 3000) - 禁用首次连接阻塞（适合容器启动场景）：
ClientPolicy.AlwaysUseProxy = false（默认 true，会尝试连所有 seed 节点） - 若集群节点 IP 经常漂移（如 K8s Service），务必设
ClientPolicy.UserAddress = true，否则 client 会缓存初始解析的 IP 并拒绝更新
写操作避免 Put() 误用引发吞吐瓶颈
Put() 默认走 WRITE 模式，对 data-in-memory true 的 namespace 会强制刷盘（即使没配 commit-to-device），实测吞吐比 PutBins() 低 40%+；而 PutBins() 可复用已有 key 结构，跳过 schema 检查和元数据重建。
立即学习“go语言免费学习笔记（深入）”；
- 高频写场景一律用
client.PutBins(policy, key, bins...)，其中bins是[]*aerospike.Bin - 避免在循环里反复 new
aerospike.Key：复用 key 实例，仅调key.SetValue() - 批量写不用
client.BatchPut()—— 它内部是串行发包；改用client.BatchOperate()+aerospike.Operations.Put()，单次 batch 最多 1000 key，延迟稳定在 2–5ms
监控连接池与错误码才能定位真实瓶颈
90% 的“慢查询”实际是连接池打满或后台线程卡住，但日志只显示 timeout。Aerospike Go 客户端不暴露连接池状态，需靠 client.Stats() 和错误码反推。
- 定期采集：
stats := client.Stats()，重点关注stats["client_connections_open"]（应 stats["client_connections_closed"]（突增说明频繁重连） - 捕获关键错误：
aerospike.ErrConnectionPoolEmpty（扩ClientPolicy.ConnectionQueueSize）、aerospike.ErrTimeout（非网络问题，大概率是服务端磁盘 IO 延迟尖峰） - 不要忽略
ErrServerFull：表示节点内存或设备队列满，此时降级策略比重试更有效
真正难的是让 client 在节点动态扩缩容时不抖动 —— 这得靠 client 自身的 mesh heartbeat 感知机制，而不是靠你轮询 /cluster API。只要 seed list 里至少一个节点始终可达，其余节点上下线都是热感知的，但前提是你的 ClientPolicy 没关掉 FailOnClusterChange（默认 false，别改）。
