WordPress自定义字段失效 实用排查修复全指南

你有没有遇过这种情况？用WordPress做开发改主题，好不容易调好的自定义字段，突然要么后台找不到，要么前台不显示，整得人一头雾水对吧？我之前改客户主题的时候踩过好几次这个坑，折腾半天才摸清楚所有可能的原因，今天直接把干货掏给你。

最多见的：插件主题兼容冲突

说白了，八成的自定义字段失效都是冲突搞出来的，就像你穿了两件套头毛衣挤在一起，肯定舒展不开。

怎么一分钟定位问题？

• 先把所有第三方插件全部停用，刷新自定义字段编辑页，如果恢复正常，那就是插件的锅。接下来一个个开启插件测试，开到哪个又失效了，直接换掉那个插件或者找开发者修兼容性就行。
• 停用插件还是不行？那就换成WordPress官方默认主题测试，比如现在默认的二四主题，如果换完就正常，那就是你当前用的主题改写了自定义字段的注册逻辑，找主题作者调个参数就行，不是什么大问题。

后台找不到自定义字段？其实只是没开显示

很多新手刚玩WordPress，其实根本不是失效，是自定义字段被藏起来了！我刚入门的时候就犯过这个傻，还以为程序出bug了，折腾半天发现就是没勾显示。

操作超简单：打开你要编辑的文章/自定义文章类型页面，点右上角三个点的更多选项按钮，拉到最底部点「偏好设置」，弹出来的面板里找到自定义字段，打勾保存，回去刷新页面，这不就出来了？

自定义文章类型漏了注册支持

如果你是自己写代码加的自定义文章类型，十有八九是漏加了自定义字段的支持参数，这不失效才怪对吧？就像你办门禁卡没给你开单元门权限，你当然进不去啊。

找到你注册自定义文章类型的代码，加上custom-fields支持就行，参考这段：

``` 'register_post_type' => array( 'supports' => array( 'title', 'editor', 'thumbnail', 'custom-fields' ) ); ```

加完保存刷新，自定义字段直接就能用了。

缓存搞出来的“假失效”

别笑，真的有超多栽在这上面的。后台看着一切正常，前台就是不显示新的自定义字段内容，那基本就是缓存搞的鬼。

不管你装了缓存插件，还是服务器开了缓存，甚至是CDN缓存，都会把旧页面存起来，新内容出不来。解决办法更简单：把站点所有缓存全部清一遍，清完强制刷新前台，百分之八十的假失效当场就好。

权限设置错了导致前台不显示

还有一种情况，后台能看到自定义字段，改也能改，就是前台不出来，那你得回头看看字段的显示权限。

如果你用的是自定义字段插件，很多插件默认会把新字段设置成仅后台可见，你没改设置，前台当然出不来，进插件设置改一下就行。要是你用的是代码调用，那得检查下，是不是字段key写错了？WordPress对字段key的大小写是敏感的，差一个字母大小写都出不来，这点真的很多人忽略。

其实说白了，WordPress自定义字段失效真不是什么大bug，大多都是小细节没注意到，按照上面的顺序排查一遍，基本都能自己搞定，不用上来就花钱找开发，对吧？