Flux v2 不是开箱即用的黑盒，需明确定义声明式资源：Go 服务镜像 tag 若含+号须配置匹配策略，image 必须抽至 Kustomization 的 images 块而非硬编码在 Deployment 中，否则 image-automation-controller 无法识别；helm-controller 仅适用于需依赖管理的复杂场景，否则易因未执行 helm dependency build 卡在 ReconciliationFailed；ImageUpdateAutomation 必须正确指定 gitRepository 和 commit.template 才能触发自动更新；健康检查需兼顾应用层 /healthz 实现与 Kubernetes probe 参数调优，避免 Ready 状态假阳性；部署前务必验证 flux get kustomization -A 是否列出目标资源，否则流水线将静默失效。
Flux v2 不是“装上就能自动部署 Go 微服务”的黑盒，它只响应你明确定义的声明式资源。如果你的 Go 服务镜像 tag 是 v1.2.0+8a3b4c，而 Kustomization 的 images 字段没配对的正则或 glob 策略，Flux 就不会更新；如果你把 image: 写死在 Deployment YAML 里，image-automation-controller 根本看不见它——部署会卡在旧版本，且无报错。
Go 微服务必须用 Kustomization 而不是裸 YAML
Flux 对 Go 项目最友好的路径是 Kustomization：它原生支持 images 字段，能直接对接 CI 中生成的 semver 或 git-describe tag。硬编码在 Deployment 里的 image: my-go-app:v1.2.0 是 Flux 的盲区。
- 把镜像字段抽到
kustomization.yaml的images:块里，例如：images: - name: my-go-app newTag: v1.2.0
- Go 构建脚本（如 Makefile）应输出带语义化版本的 tag，推荐用
git describe --tags --always --dirty，避免含+的格式，或显式配置spec.policy.semver.range支持~v1.2.0 - 不要用
helm-controller管理简单 Go 服务——除非你真需要 Helm 的依赖管理或复用 chart。它会因dependencies未helm dependency build卡在ReconciliationFailed，错误信息含"failed to resolve dependencies"
image-automation-controller 怎么才真正生效
这个控制器不主动扫描 registry，它只读 Git 仓库里已存在的 Kustomization 或 HelmRelease 文件，找到 images: 或 {{ .Values.image.tag }} 后，替换成新 tag 并 push 回 Git。漏配关键字段就等于没开开关。
在 Go 中使用 google/wire 实现编译时依赖注入——wire.NewSet、wire.Build、wire.Bind（接口→实现）、wire.Struct、wire.Value、wire.Interface
-
ImageUpdateAutomation必须指定spec.checkout.gitRepository（指向存 Kustomization 的 repo，不是应用代码 repo） -
spec.commit.template要写清楚，比如"{{.Revision}} {{.Message}}"，否则即使检测到新 tag，也不会 commit + push - 确保 Git 仓库的写权限已通过
GitRepository的spec.secretRef正确注入，常见错误是 token 权限不足，导致 push 失败但 Flux 不报错
健康检查和 Ready 状态容易假阳性
Flux 只确认 Kubernetes 资源是否创建成功，不验证 Go HTTP server 是否真在监听。一个 deployment 显示 Ready，但 curl http://my-go-app/healthz 返回 503，很可能是 readiness probe 配置太激进，或 Go 应用启动慢于 probe 初始延迟。
立即学习“go语言免费学习笔记（深入）”；
- 在 Go 服务中实现
/healthzendpoint，并确保它返回 200 仅当所有依赖（DB、cache）已连通 - Kubernetes manifest 中的
readinessProbe.initialDelaySeconds至少设为 Go 服务冷启动耗时 + 5s；用livenessProbe.failureThreshold控制重启容忍度 - Flux 的
Kustomization资源可加spec.healthChecks字段引用 Service 或 Deployment，但注意：它只检查资源 condition，不替代应用层 probe
最常被跳过的一步是验证 flux get kustomization -A 是否真列出你的资源——如果返回空，不是 Git 没提交，而是 kustomize-controller 根本没部署，或者 CRD Kustomization 没装全。这个状态无声无息，却让整个 GitOps 流水线停摆。
