Magento 2.4.6云项目前端styles-m.css缺失问题求助

问题背景 #

• Magento 2.4.6云项目，已在app/etc/config.php中禁用CSS合并与压缩功能
• 代码推送至预发布环境部署后，前端网站缺失styles-m.css文件导致页面崩溃，但后端管理面板运行正常
• 静态内容部署（SCD）耗时长达40分钟，执行空提交重新部署后问题仍反复出现

核心问题定位 #

查看提供的.magento.env.yaml配置，发现deploy阶段的CLEAN_STATIC_FILES项存在语法错误：

CLEAN_STATIC_FILES: trueƒst

此处的trueƒst为无效值，会直接导致静态文件清理与生成流程异常，是引发styles-m.css缺失的关键诱因。

修复步骤 #

1. 修正配置文件语法错误 #

编辑.magento.env.yaml，将deploy段的CLEAN_STATIC_FILES修正为有效布尔值：

stage:
  global:
    SKIP_HTML_MINIFICATION: true
  build:
      SKIP_SCD: false
      SCD_STRATEGY: "compact"
  deploy:
    CLEAN_STATIC_FILES: true
    CRON_CONSUMERS_RUNNER:
      cron_run: true
      max_messages: 1000
      consumers:
        - product_action_attribute.update
        - exportProcessor
        - async.operations.all

2. 调整SCD策略优化生成效率 #

当前使用compact策略，对于大型项目可切换为quick策略并行生成静态内容，大幅缩短SCD耗时：
在.magento.env.yaml的build段修改策略配置：

SCD_STRATEGY: "quick"

注：quick策略适合预发布环境快速验证，生产环境若需完整静态资源优化，可后续再切换回compact。

3. 强制静态文件重新生成 #

若默认部署流程未触发完整静态资源生成，可修改.magento.app.yaml的deploy钩子，添加强制生成命令：

deploy: |
    php bin/magento static:content:deploy --force
    php ./vendor/bin/ece-tools deploy

注：--force参数会强制覆盖现有静态文件，确保新资源被正确生成。

4. 验证CSS禁用配置正确性 #

确认app/etc/config.php中CSS合并与压缩的禁用配置无误：

'system' => [
    'default' => [
        'dev' => [
            'css' => [
                'merge_css_files' => '0',
                'minify_files' => '0',
            ],
        ],
    ],
],

5. 重新部署项目 #

提交修改后的配置文件并推送至预发布分支：

git add .magento.env.yaml .magento.app.yaml app/etc/config.php
git commit -m "Fix static files generation: correct config syntax and adjust SCD strategy"
git push origin <your-preprod-branch>

额外排查点 #

• 检查预发布环境磁盘空间：确认pub/static挂载的共享磁盘（当前配置2048MB）有足够容量容纳静态资源
• 查看部署日志：通过云平台控制台查看ece-tools部署日志，排查是否存在静态文件生成失败的具体报错
• 核对主题依赖：确认前端使用的主题未依赖未安装的扩展或缺失的CSS资源

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