Minikube 启动失败主因是虚拟化驱动不兼容或未启用：macOS Sequoia 需改用 docker 驱动，Windows 推荐 Docker Desktop 自带驱动；Service 访问须用 minikube ip 而非 localhost；Skaffold 应复用 minikube docker-env；本地调 K8s API 需用 clientcmd 加载 kubeconfig 而非 rest.InClusterConfig。
Minikube 启动失败：minikube start 卡住或报 driver not found
根本原因不是 Go 代码问题，而是 Minikube 依赖的虚拟化驱动没装对或没启用。Mac 上默认用 hyperkit，但 macOS Sequoia（15+）已不兼容；Windows 默认要开 Hyper-V 或 WSL2，但很多开发者其实只装了 Docker Desktop——它自带 docker 驱动，反而最稳。
- 先确认本地 Docker 是否运行：
docker ps能返回结果就行 - 强制指定驱动启动：
minikube start --driver=docker（跳过所有虚拟机驱动冲突） - 别碰
--cpus或--memory参数，除非你明确知道宿主机余量；默认值（2 CPU / 2GB 内存）对 Go 微服务够用 - 如果提示
Failed to setup kubeconfig，手动执行：minikube update-context
Go 微服务连不上 Minikube 的 Service（connection refused）
Go 程序里硬写 http://localhost:30080 是错的——Minikube 的 NodePort 服务监听在虚拟机 IP 上，不是宿主机 localhost。得用 minikube ip 拿真实地址，再拼端口。
- 查 Minikube 虚拟机 IP：
minikube ip（通常类似192.168.49.2） - 查 Service 的 NodePort：
kubectl get service my-service -o jsonpath='{.spec.ports[0].nodePort}' - Go 里请求地址应为：
http://192.168.49.2:30080，而非localhost - 如果用
ClusterIP类型，Go 程序必须也在集群内（比如跑在 Pod 里），本地调试别选这个类型
用 skaffold dev 热重载 Go 服务时镜像总拉不到本地 Minikube
Skaffold 默认推镜像到远程 registry，但 Minikube 自带本地 registry（minikube cache），推过去才能被 Pod 拉取。关键在于让 Skaffold 把镜像加载进 Minikube，而不是 push 到 docker.io。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 确保
skaffold.yaml中build.artifacts[].image名字不含docker.io/前缀（例如用myapp，不是docker.io/myapp） - 启动时加参数：
skaffold dev --default-repo=$(minikube docker-env | grep DOCKER_HOST | cut -d'=' -f2 | sed 's/"//g')/—— 实际更简单：直接用skaffold dev --insecure-registry="192.168.49.2:5000"并配好 Minikube registry 插件 - 推荐省事法：运行
eval $(minikube docker-env)，再执行skaffold dev，这样 Skaffold 会自动复用 Minikube 的 Docker daemon，构建完直接可用
Go 程序里调 Kubernetes API（client-go）连不上 Minikube 的 https://192.168.49.2:8443
不是证书问题，是 Go 的 rest.InClusterConfig() 在本地跑会 panic，因为找不到 /var/run/secrets/kubernetes.io/serviceaccount 目录。必须用 rest.InClusterConfig() 以外的方式——也就是 rest.InClusterConfig() 不适用于本地调试。
立即学习“go语言免费学习笔记（深入）”；
- 本地调试一律用
rest.InClusterConfig()的替代方案：rest.InClusterConfig()改成clientcmd.BuildConfigFromFlags("", filepath.Join(os.Getenv("HOME"), ".kube", "config")) - 确保
kubectl config current-context输出的是minikube，否则 Go 程序会连错集群 - 如果报
x509: certificate signed by unknown authority，说明 Minikube 的 CA 证书没被 Go 信任——别手动加证书，直接用rest.InClusterConfig()自动读取 kubeconfig 里的certificate-authority-data字段即可
Minikube 的坑不在 Go 语法，而在“以为它是个轻量版 K8s”，其实它是个带状态的虚拟机；每次 minikube delete 后，.kube/config 里 context 可能残留旧 IP，得手动清理或重置。
