Google App Engine Flex（PHP 8.3/Yii2）静态文件无法加载问题

原本运行在PHP 7.4环境下的Yii2 Google App Engine站点，升级至PHP 8.3后站点可正常运行，但原可正常访问的静态文件（如CSS、JS等）全部返回404，所有静态文件请求似乎都被路由到了index.php。目前使用的app.yaml配置如下：

runtime: php
env: flex

runtime_config:
    operating_system: ubuntu22
    runtime_version: 8.3
    document_root: web

manual_scaling:
  instances: 1
resources:
  cpu: 1
  memory_gb: 0.5
  disk_size_gb: 10

• 明确配置静态文件路由规则
  在app.yaml中添加handlers配置块，指定静态文件的路径与处理逻辑，避免请求被转发到index.php。示例配置如下：

  runtime: php
  env: flex
  
  runtime_config:
      operating_system: ubuntu22
      runtime_version: 8.3
      document_root: web
  
  handlers:
    # 匹配CSS文件路径
    - url: /css
      static_dir: web/css
    # 匹配JS文件路径
    - url: /js
      static_dir: web/js
    # 匹配图片文件路径
    - url: /images
      static_dir: web/images
    # 按需添加其他静态资源路径规则
    # 最后处理所有动态请求
    - url: /.*
      script: auto
  
  manual_scaling:
    instances: 1
  resources:
    cpu: 1
    memory_gb: 0.5
    disk_size_gb: 10
  

  注意static_dir需对应项目中静态文件的实际存放路径，确保与document_root的相对位置正确。

• 检查Yii2 URL管理器配置
  打开项目根目录的config/web.php，确认urlManager组件未将静态文件路径纳入动态路由规则。示例正确配置：

  'urlManager' => [
      'enablePrettyUrl' => true,
      'showScriptName' => false,
      'rules' => [
          // 动态路由规则，避免匹配静态文件路径
          '<controller:\w+>/<action:\w+>' => '<controller>/<action>',
      ],
  ],
  

  若有自定义规则，需确保其不会匹配/css、/js这类静态资源路径。

• 验证静态文件权限
  检查项目中静态文件的权限设置，确保App Engine运行环境具备读取权限。本地开发时可通过chmod -R 644 web/css web/js web/images调整权限，部署前确认权限配置正确。

• 确认静态文件部署状态
  部署后通过Google Cloud Console查看App Engine实例的文件结构，确认静态文件已被部署到指定的web目录下，避免因.gitignore规则或部署配置遗漏导致文件未上传。

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