在mu目录创建自定义Post Type引发JSON响应错误及媒体库异常求助

排查自定义Post Type代码问题 #

• 检查代码是否有意外输出：比如echo、print、var_dump等调试函数，甚至<?php标签前后的多余空格/换行，这些内容会让REST API返回非JSON格式内容，直接触发报错。
• 验证register_post_type参数：确保show_in_rest配置正确——不需要REST API支持的话设为false；需要的话检查rest_base和rest_controller_class，避免和默认文章的REST路由冲突。
• 临时注释自定义Post Type代码，测试文章更新和媒体库，若恢复正常，可确认问题出在这段代码中。

调整加载顺序与ACF兼容性 #

• MU插件加载优先级高于主题和普通插件，可能与ACF初始化逻辑冲突。把自定义Post Type的注册钩子优先级调至10之后，示例代码：

  add_action('init', 'register_my_custom_post_type', 20);
  

  确保ACF先完成初始化流程。
• 检查ACF字段组的显示条件：避免默认文章编辑页加载不属于它的ACF字段，这类错误会引发前端JS异常，进而影响文章保存功能。

调试REST API返回内容 #

• 开启WP调试模式，在wp-config.php中添加以下配置：

  define('WP_DEBUG', true);
  define('WP_DEBUG_LOG', true);
  define('WP_DEBUG_DISPLAY', false);
  

  触发错误后查看wp-content/debug.log文件，定位具体报错的文件和行号。
• 直接访问REST API端点（比如/wp-json/wp/v2/posts/[文章ID]），确认返回内容为纯JSON格式，无额外HTML或文本混入。

修复媒体库显示问题 #

• 媒体库依赖/wp/v2/media REST端点，排查自定义Post Type代码是否修改了REST路由（比如使用register_rest_route或rest_api_init钩子），避免干扰默认媒体路由的正常工作。
• 检查是否有代码过滤了wp_get_attachment_image_src或wp_prepare_attachment_for_js等媒体相关函数，导致图片URL错误或数据格式异常。

长期优化路径 #

• 封装自定义Post Type代码：用独立类或函数实现，避免全局变量污染和意外输出。
• 使用register_post_type_args过滤器修改默认Post Type参数，而非直接注册可能引发冲突的自定义类型。
• 在MU插件中注册Post Type时添加条件判断，比如仅在前端加载，或排除后台特定页面。
• 定期测试代码与WordPress、ACF最新版本的兼容性，避免版本更新带来的参数变更问题。

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