WordPress保存functions.php偶发失败提示更改未保存是何原因

这个Something went wrong. Your change may not have been saved是WordPress内置文件编辑器的通用失败提示，清空文件全部内容依然无法保存的特征，说明问题和PHP代码语法错误无关，以下是按出现概率排序的核心原因：

• 主机侧WAF/安全规则拦截
  这是该类随机报错的最高发诱因。绝大多数云主机、共享主机会默认开启WAF规则（比如ModSecurity规则集、云厂商自定义Web防护规则），会将编辑器提交的PHP代码内容判定为恶意Web注入攻击。由于规则匹配存在概率性：提交内容刚好没命中特征码就能保存成功，命中特征码就直接拦截请求，完全符合无规律故障的特征。部分严格的防护规则甚至不校验提交内容，只要命中特定请求路径、请求头特征就会拦截，哪怕提交的是空文件也会报错。可以临时关闭主机面板的WAF功能测试，如果恢复正常就联系主机商将WordPress后台编辑器的请求路径加入白名单即可，不建议长期关闭WAF。
• 文件与目录权限配置错误
  先通过FTP或者主机文件管理器检查目标functions.php的权限，以及该文件所在主题目录的权限：单文件权限建议设置为644，目录权限建议设置为755。如果权限配置混乱（比如误设为777会被安全规则拦截，或者PHP进程用户没有稳定写入权限），就会出现随机写入失败的情况。注意不要为了方便把文件权限改成777，这是非常危险的配置，反而会触发绝大多数主机的安全拦截策略。
• 编辑器依赖的REST API请求被拦截或异常
  WordPress后台的文件编辑器从5.x版本开始就通过REST接口完成保存操作，可以按F12打开浏览器开发者工具，切换到「网络」标签，复现保存失败的操作，找到对应的wp-json/wp/v2/themes/开头的请求，查看具体响应状态码排查：
  • 如果返回403状态码：优先排查站点安装的安全插件、防篡改插件的规则，这类插件很多会默认限制对主题文件的修改，部分插件的拦截规则存在触发阈值，会出现随机拦截的情况
  • 如果返回413状态码：是服务器限制了POST请求的最大体积，修改php.ini配置中的post_max_size、upload_max_filesize参数到合理值即可
  • 如果返回500状态码：查看服务器PHP错误日志，排查是否存在PHP进程临时资源耗尽、磁盘写入权限临时失效的问题
• 服务器缓存或文件锁冲突
  如果服务器开启了OPcache、主机侧强制文件缓存，或者存在文件系统锁机制异常，可能出现第一次保存时缓存刚好过期、文件锁未被占用所以保存成功，第二次操作时碰到缓存锁、文件排他锁未释放，就会写入失败。可以尝试清空站点所有缓存、重启PHP服务后再测试，必要时临时关闭OPcache验证是否为缓存冲突导致。
• 服务器存储资源耗尽
  如果站点所在服务器的磁盘分区写满，或者磁盘inode号被耗尽（小文件太多占满所有文件索引），PHP进程没有多余空间写入临时文件、更新目标文件，也会出现随机写入失败的问题，和提交的文件内容无关，空文件也无法保存。登录服务器查看磁盘使用率、inode使用率即可确认，清理冗余日志、备份文件释放空间就能恢复。

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