deployment 的 image 字段必须为可拉取的完整镜像地址，如 ghcr.io/yourname/myapp:v1.2；targetport 必须与 go 程序实际监听端口一致；需配置 readinessprobe 保障服务就绪后再接入流量；configmap/secret 挂载为文件时须改代码读取而非 os.getenv。
Deployment 的 image 字段必须指向可拉取的镜像，不是本地构建路径
很多人写完 Go 服务就直接在 deployment.yaml 里填 image: ./cmd/myapp 或 image: myapp:latest，结果 kubectl apply 成功但 Pod 一直卡在 ImagePullBackOff。Kubernetes 节点根本看不到你本地 Docker daemon 里的镜像。
实操建议：
- 用
docker build -t your-registry.com/your-ns/myapp:v1.2 .构建，并docker push到私有或公有仓库（如 ghcr.io、ECR、Harbor） -
image字段必须是完整镜像地址，例如ghcr.io/yourname/myapp:v1.2，带域名、命名空间、tag - 如果用私有仓库，记得配
imagePullSecrets，否则拉不到 - Go 二进制建议静态编译（
CGO_ENABLED=0 go build -a -ldflags '-extldflags "-static"' -o myapp .），避免 Alpine 镜像里缺 libc
Service 的 targetPort 必须和 Go 程序监听端口一致，不是容器 EXPOSE
Go 代码里写了 http.ListenAndServe(":8080", nil)，Dockerfile 里写了 EXPOSE 8080，但 Service 的 targetPort: 80 —— 这时候请求全 503。Kubernetes 不看 EXPOSE，只认 targetPort 和容器实际监听的端口。
实操建议：
- 先确认 Go 程序监听的是哪个端口：查
net.Listen或http.ListenAndServe参数，常见是:8080或:3000 -
targetPort填数字（如8080）或字符串（如"http"），但必须和程序监听端口完全匹配 -
port是 Service 对外暴露的端口（比如设成80），客户端访问http://service-name:80，K8s 自动转发到targetPort - 别依赖 Dockerfile 的
EXPOSE，它只是文档作用，不影响网络行为
Go 程序启动前要等 readinessProbe 就绪，否则流量进来就 502
刚部署时 Pod 已 Running，但 Go 服务还在加载配置、连数据库、初始化缓存——这时 Service 已把流量转过来，请求直接失败。现象是日志里没报错，但 curl 返回 502 或超时。
Colly 是一个用于 Go 语言的快速开源爬取和爬虫框架。它适用于从简单的页面提取到异步爬虫处理大量页面集合，支持请求回调和结构化解析。
实操建议：
- 在 Deployment 里加
readinessProbe，用 HTTP GET 检查健康端点，比如/healthz - Go 里快速加一个 handler：
http.HandleFunc("/healthz", func(w http.ResponseWriter, r *http.Request) { w.WriteHeader(200) }) - 设置
initialDelaySeconds: 5和periodSeconds: 10，避免探针太急打挂服务 - 别用
livenessProbe替代 readiness；重启解决不了初始化慢的问题，反而让 Pod 反复 CrashLoopBackOff
ConfigMap 挂载环境变量时，Go 读 os.Getenv 没问题，但挂载文件就得改代码读文件
有人把数据库地址写进 ConfigMap，用 envFrom 注入，Go 里用 os.Getenv("DB_URL") 正常取到；但换成了 volumes + volumeMounts 挂成文件（比如 /etc/config/db.yaml），还继续用 os.Getenv，结果空指针 panic。
实操建议：
- 环境变量方式：用
envFrom+configMapRef，Go 直接os.Getenv读，简单可靠 - 文件方式：挂载后路径固定（如
/etc/config/app.conf），Go 得用ioutil.ReadFile或os.Open读，不能指望环境变量 - 敏感信息（密码、token）优先用
Secret，挂载方式同 ConfigMap，只是解码逻辑不同（base64） - 挂载文件时注意权限：默认是只读，且 uid/gid 可能不匹配，Go 程序若需写日志到同一目录会失败
最常被跳过的其实是 readinessProbe 的 initialDelaySeconds 和镜像 tag 的语义——用 latest 看似省事，但下次重拉可能已是另一个版本，连日志格式都变了。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
