local path provisioner 是 kubernetes 动态供应本地存储的轻量级工具，支持 hostpath/local 卷类型、节点级路径映射、自动 pv 创建与清理，需配合正确权限、nodepathmap 和 storageclass 配置方可稳定支撑 composer 等敏感工作负载。
Composer 本身不直接操作 Kubernetes 存储卷，但你在构建 PHP 镜像时若依赖本地路径挂载（比如 vendor 目录复用、composer.lock 缓存共享），就极可能因 Local Path Provisioner 配置不当或调度错位导致构建失败、缓存失效甚至 Pod 卡在 Pending 状态。
为什么 composer install 会卡住或报 permission denied？
常见现象是构建阶段执行 composer install 时失败，错误类似：Permission denied: vendor/autoload.php 或 Could not write to /app/vendor。根本原因不是 Composer 问题，而是挂载的本地卷路径权限或 SELinux 上下文未对齐。
-
local-path-provisioner默认创建的 PV 使用hostPath类型，目录由 provisioner 自动创建（如/opt/local-path-provisioner/pvc-xxx），但该目录属主是root:root，而容器内 PHP 进程通常以非 root 用户（如www-data）运行 - 如果你在
config.json中配置了"paths": ["/data1"]，但宿主机上/data1未提前chown 33:33 /data1（对应 www-data UID/GID），就会触发权限拒绝 - Kubernetes 不会自动修正挂载点权限 —— 它只负责绑定路径，不干预文件系统级属主
如何让 vendor 目录真正“跨构建复用”？
很多人想用 Local Volume 挂载 /app/vendor 实现 Composer 依赖复用，但实际效果往往不如预期。关键在于：PVC 是按 Pod 生命周期绑定的，而构建过程（docker build 或 CI Job）并不走 PVC 流程；只有运行时 Pod 才会挂载。
- 真正能复用 vendor 的场景，仅限于：你用
initContainer先拉取并安装依赖到一个本地 PV，再通过emptyDir或hostPath共享给主容器 —— 但这要求 initContainer 和主容器调度到同一节点，且 PV 已存在 - 更现实的做法是：在 CI 构建镜像阶段用多阶段构建（
FROM composer/composer:latest-bin as builder），把vendor安装进镜像层，而非依赖运行时挂载 —— 这样既规避调度限制，又保证一致性 - 若坚持运行时挂载，请确保 PVC 的
accessModes是ReadWriteOnce，且 StatefulSet 或 Pod 的nodeAffinity与 PV 的nodeAffinity严格匹配，否则调度器无法绑定
StorageClass 的 parameters 怎么影响 composer 工作流？
local-path-provisioner 的 StorageClass 支持 nodePath 参数，但它只控制 PV 创建时的根路径，不改变挂载行为本身。容易被忽略的是：这个参数必须与 ConfigMap 中 nodePathMap 的 paths 列表完全一致，否则 provisioner 会 fallback 到默认路径，导致你预期挂载 /data/ssd 却实际写入 /opt/local-path-provisioner。
- 错误示例：
storageClassName: fast-local-path对应的 SC 定义中parameters: { "nodePath": "/data/fast-ssd" }，但 ConfigMap 里没配"node": "DEFAULT_PATH_FOR_NON_LISTED_NODES", "paths": ["/data/fast-ssd"]—— 结果就是路径映射失败 - 验证方式：创建 PVC 后，
kubectl get pv -o wide查看HOSTPATH字段是否为你指定的路径；如果不是，说明nodePathMap未生效 - 不要在多个 StorageClass 中混用相同
nodePath值 —— provisioner 不校验唯一性，但会导致 PV 创建冲突或路径覆盖
Local Volume 的本质是“节点绑定”，不是“数据共享”。Composer 的极速构建依赖确定性路径和权限，而 Kubernetes 本地存储的脆弱点恰恰在节点粒度的配置一致性 —— 少一个 chown，少一行 nodePathMap，整个构建链路就可能中断。别指望自动修复，得手动对齐每一层。
