Skaffold同步文件后K3d集群中Lumen应用仍保持初始状态

核心原因 #

Lumen（Laravel生态框架）在非本地环境会自动缓存配置、路由、视图等内容，即便容器内文件已通过Skaffold同步更新，应用仍会读取缓存内容；另外如果使用PHP-FPM作为运行时，PHP进程不会自动检测文件变更，需要手动触发重载才能加载新文件。

解决方案 #

1. 确保容器内Lumen运行在本地开发环境 #

检查Dockerfile或K8s部署配置中的环境变量，确认APP_ENV=local、APP_DEBUG=true：

• 在Dockerfile中添加：

ENV APP_ENV=local
ENV APP_DEBUG=true

• 或者在K8s Deployment的env字段中设置：

env:
  - name: APP_ENV
    value: "local"
  - name: APP_DEBUG
    value: "true"

本地环境下Lumen不会自动生成缓存，能直接读取最新的文件内容。

2. 配置Skaffold同步后自动清理缓存 #

修改Skaffold配置，在同步规则中添加postSync命令，同步文件后自动清理Lumen各类缓存：

apiVersion: skaffold/v2beta29
kind: Config
metadata:
  name: api
build:
  tagPolicy:
    sha256: {}
  artifacts:
    - image: api
      docker:
        dockerfile: Dockerfile
      sync:
        manual:
          - src: '**/*'
            dest: '/var/www/html'
            # 同步后执行缓存清理命令
            postSync:
              command: ["sh", "-c", "php /var/www/html/artisan cache:clear && php /var/www/html/artisan route:clear && php /var/www/html/artisan config:clear"]
deploy:
  kustomize:
    paths:
      - k8s/dev
profiles:
  - name: base
    deploy:
      kustomize:
        paths:
          - k8s/base

3. PHP-FPM运行时需触发进程重载 #

如果你的容器使用PHP-FPM运行Lumen，同步文件后需要重载FPM才能让新文件生效，把重载命令加入postSync：

postSync:
  command: ["sh", "-c", "php /var/www/html/artisan cache:clear && kill -USR2 $(cat /var/run/php-fpm.pid)"]

（注意调整php-fpm.pid的路径，需匹配你的容器配置）

验证步骤 #

1. 重启Skaffold Dev模式：skaffold dev
2. 修改本地Lumen代码，等待Skaffold完成文件同步
3. 调用API接口，确认修改已生效

内容的提问来源于stack exchange，提问作者KubiRoazhon