Shopware 6无法保存主题配置 报500执行超时错误如何修复

问题核心原因 #

保存主题主色等样式变量时，Shopware会调用sabberworm/php-css-parser全量解析、重编译主题关联的所有CSS/SCSS资源。当主题存在大量冗余样式、不规范CSS写法，或是依赖包版本存在解析效率bug时，解析耗时超过PHP默认配置的30秒最大执行时间，就会触发该致命错误，前端表现为接口500、配置保存失败。

临时应急修复方案 #

• 调高PHP执行时限：修改PHP配置项max_execution_time = 120，如果使用PHP-FPM运行模式，同步修改FPM配置里的request_terminate_timeout = 120，修改完成后重启PHP-FPM、Nginx/Apache服务即可生效。该方案仅临时放宽限制，没有解决解析效率低的根源问题，后续样式文件体积增长后可能再次复现。
• 清空存量编译缓存：在项目根目录执行控制台命令bin/console cache:clear，同时手动删除public/theme目录下所有已编译的旧主题资源，再重新尝试保存配置，部分场景下旧缓存的冗余样式会导致重复解析触发超时。

永久根治方案 #

• 排查优化自定义样式代码
  • 梳理自定义主题、第三方插件注入的SCSS/CSS代码，删除未使用的冗余样式、无效注释、过深的嵌套规则，优先对静态CSS资源做压缩处理，减少解析器的处理工作量。
  • 重点排查不规范写法：包括未闭合的样式选择器、多层嵌套的媒体查询、直接嵌入CSS的超大体积base64字体/图片资源，这类内容会数倍拉高解析耗时。
• 升级存在bug的依赖版本
  Shopware 6.4.x早期版本内置的sabberworm/php-css-parser存在递归解析效率缺陷，可在项目根目录执行composer update sabberworm/php-css-parser --with-dependencies，将该依赖升级到8.3.1以上的兼容版本，升级前提前做好代码备份，避免出现版本兼容问题。
• 排查第三方插件干扰
  逐个禁用涉及主题样式修改、前端资源注入的第三方插件测试，部分低质量插件会重复挂载CSS解析事件，导致同一份样式文件被多次重复解析，无意义拉长整体处理耗时。

修复完成后建议在测试环境验证，确认主题保存请求整体耗时降到10秒以内再同步到生产环境。

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