生产服务器（Bitbucket仓库）CSS修改不生效问题求助

1. 排查服务器端Git部署同步问题 #

• 检查部署脚本/定时任务：很多Git自动部署会用cron定时拉取，若设置了4-5小时的定时周期，就会导致延迟。手动在服务器执行git pull，然后直接查看服务器上的CSS文件内容（比如cat /var/www/html/wp-content/themes/your-theme/style.css），对比Bitbucket仓库的版本，如果服务器文件没更新，就是部署逻辑漏了CSS同步或定时周期过长。
• 修复文件权限：Linux服务器上，Web服务用户（如www-data）可能没有CSS目录的写入权限，导致Git拉取后文件无法覆盖。执行以下命令调整权限：

  chown -R www-data:www-data /var/www/html/wp-content/themes/your-theme/css
  chmod -R 755 /var/www/html/wp-content/themes/your-theme/css
  

2. 清理隐藏的服务器/CDN缓存层 #

• 服务器静态缓存：如果用了Nginx、Varnish或OPcache，这些缓存层不会被WP Rocket或Cloudflare的清理命令影响：
  • Nginx：修改配置文件中静态文件的expires指令（临时设为expires 1m;），然后重启Nginx：systemctl restart nginx
  • OPcache：执行php -r "opcache_reset();"重置PHP缓存
• Cloudflare深度清理：开启Cloudflare「发展模式」临时关闭缓存测试，清缓存时选择「清除所有缓存」，而非仅清除特定文件。同时检查缓存规则，避免给CSS设置过长的过期时间。

3. 排查WordPress内部缓存机制 #

• 主题自带缓存：部分主题会自动生成压缩版CSS或静态缓存文件，Git推送后不会自动触发重新生成，需要在主题后台找到「清除样式缓存」或「重新生成合并CSS」的按钮。
• 其他优化插件：除了WP Rocket，检查是否安装了Autoptimize、WP Super Cache等插件，这些插件可能单独缓存CSS，需手动清除它们的缓存，或临时禁用测试。

4. 强制浏览器加载最新CSS的临时方案 #

在主题的functions.php中修改CSS加载代码，添加文件修改时间作为版本号，让浏览器识别到文件更新：

wp_enqueue_style('theme-main-style', get_stylesheet_uri(), array(), filemtime(get_stylesheet_directory() . '/style.css'));

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