无需插件在WordPress添加自定义文章类型报错排查与修复

可能的问题分析 #

• 语法错误（最常见）：你的代码中'show_in_rest' => true,行末尾多了一个逗号。在PHP 5.3及更早版本中，数组最后一个元素后加逗号会触发语法错误；即使是高版本PHP，部分环境配置也可能对这种写法敏感，直接导致网站崩溃。
• functions.php文件结构损坏：粘贴代码时可能误删了主题原有代码的关键部分（比如闭合括号、分号），破坏了整个文件的语法结构。
• 缺乏具体错误提示：WordPress默认只显示通用报错，看不到具体问题位置，增加了排查难度。

修复步骤 #

1. 修正代码语法
   移除数组最后一个元素的多余逗号，修改后的完整代码如下：

   function create_posttype() {
   
       register_post_type( 'movies',
       // CPT Options
           array(
               'labels' => array(
                   'name' => __( 'Movies' ),
                   'singular_name' => __( 'Movie' )
               ),
               'public' => true,
               'has_archive' => true,
               'rewrite' => array('slug' => 'movies'),
               'show_in_rest' => true
   
           )
       );
   }
   // Hooking up our function to theme setup
   add_action( 'init', 'create_posttype' );
   

2. 检查functions.php完整性
   通过FTP或主机文件管理器打开主题的functions.php，确认文件开头到结尾的代码结构完整，没有遗漏闭合的{}或分号。

3. 启用调试模式定位问题
   打开网站根目录的wp-config.php文件，找到define( 'WP_DEBUG', false );，替换为：

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

   此时网站会显示具体错误信息，方便精准排查。调试完成后记得改回false，避免暴露敏感信息给访客。

4. 刷新重写规则
   修复代码并恢复网站后，登录WordPress后台，进入「设置」→「固定链接」，直接点击「保存更改」（无需修改任何设置），刷新WordPress重写规则，确保自定义文章类型的菜单和URL正常生效。

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