go mod vendor 在 Kubernetes Pod 中失败的根本原因是 Pod 的 /go/src 默认为只读文件系统，而 vendor 操作需写入 vendor/ 目录，导致 permission denied；正确解法是通过 emptyDir + subPath 精准挂载 go.mod 和 go.sum，并设置 GO111MODULE=on，配合可写缓存路径与 -mod=readonly 构建模式确保安全可靠执行。
为什么 go mod vendor 在 Kubernetes Pod 里总失败？
因为 Pod 默认的 /go/src 是只读文件系统，而 go mod vendor 会尝试写入 vendor/ 目录——直接报错 permission denied 或 read-only file system。
本地开发时你可能习惯在宿主机跑 go mod vendor 再 COPY 进镜像，但这会导致构建缓存失效、调试周期拉长，且无法热重载模块变更。
- 真正可行的路径是：把
go.mod和go.sum挂进 Pod，让go工具链在容器内执行依赖解析，但避开只读限制 - 关键不是“挂载代码”，而是“挂载可写的模块缓存 + 可写的 vendor 路径”
-
GO111MODULE=on必须显式设置，否则 Pod 内go可能 fallback 到 GOPATH 模式，忽略go.mod
用 emptyDir + subPath 精准挂载 go.mod 和 go.sum
别整个代码目录用 hostPath 挂载——既不安全又破坏构建一致性。只挂两个文件，其余走 go build -mod=readonly 安全模式。
示例片段（Pod spec）：
立即学习“go语言免费学习笔记（深入）”；
volumeMounts:
- name: go-mod
mountPath: /workspace/go.mod
subPath: go.mod
- name: go-mod
mountPath: /workspace/go.sum
subPath: go.sum
volumes:
- name: go-mod
hostPath:
path: /path/to/your/project
type: Directory-
subPath是关键：它让单个 volume 只暴露指定文件，避免挂载整个目录带来的权限/覆盖风险 - 确保宿主机上的
go.mod和go.sum文件可被容器内 UID 读取（常见坑：文件属主是 root，而容器用非 root 用户启动） - 挂载后，在 Pod 里执行
go list -m all能正常输出模块列表，说明解析通路已通
调试时如何让 go run 实时加载本地修改的模块？
你改了 github.com/your/repo/internal/pkg，但 go run main.go 还在用老版本——根本原因是 go 默认从 $GOMODCACHE 加载，不会自动感知本地文件变更。
- 方案一（推荐）：用
replace指向本地路径，写进go.mod：replace github.com/your/repo/internal/pkg => ./internal/pkg - 方案二：临时加
-mod=mod参数强制重读go.mod，但仅限调试，不可用于构建镜像 - 注意
replace不会触发自动go mod tidy，改完记得手动运行，否则 CI 构建可能失败 - 如果模块路径含
file://或绝对路径，Kubernetes Pod 里大概率找不到——一律用相对路径或模块名 +./前缀
go build -o 输出文件权限和挂载卷冲突怎么办？
你在 Pod 里执行 go build -o /workspace/bin/app ./cmd，结果提示 permission denied——不是 Go 的问题，是挂载卷没开写权限，或目标路径不在 emptyDir 中。
- 永远不要往
/workspace（hostPath 挂载）里写二进制，它大概率是只读的；改用emptyDir卷挂载到/tmp/build这类路径 - 构建命令必须指定
-o到可写路径，例如：go build -o /tmp/build/app ./cmd - 若用
docker build镜像，Dockerfile中的COPY . .后应立刻运行go mod download，而不是等 RUN 时再go build——前者利用 layer 缓存，后者每次重下依赖
最易被忽略的是：Kubernetes 的 securityContext.runAsUser 和宿主机文件的 umask 共同决定容器内能否写入。哪怕挂了 emptyDir，如果进程 UID 没权限写进该 volume，一样失败。调试时先 ls -ld /tmp/build 看属主和权限位，比猜更有效。
