【WordPress】カスタム投稿の記事が404になる原因と対処法｜パーマリンク・リライトルール・デバッグまで完全解説

この記事で分かること

• カスタム投稿タイプが404になる5つの原因と対処法
• パーマリンク再保存で直る理由と直らないケースの対応
• register_post_type() の rewrite パラメータの正しい設定
• リライトルールの仕組みとデバッグ方法
• アーカイブページ・ページネーションの404対策
• 本番環境での.htaccess トラブルシューティング

リクエスト処理フロー

パーマリンク再保存の手順

1. WordPress管理画面にログイン
2. 設定 → パーマリンクを開く
3. 何も変更せず「変更を保存」をクリック
4. カスタム投稿の記事にアクセスして確認

なぜこれで直るのか？
「変更を保存」を押すと、内部で flush_rewrite_rules() が実行され、すべてのリライトルールが再生成されます。新しく登録したカスタム投稿タイプのルールもこのタイミングで追加されます。

functions.php – テーマ・プラグイン有効化時にフラッシュ

// テーマの有効化時にリライトルールを再生成
function mytheme_activate() {
    // 先にカスタム投稿タイプを登録
    mytheme_register_post_types();
    // リライトルールをフラッシュ
    flush_rewrite_rules();
}
add_action( 'after_switch_theme', 'mytheme_activate' );

⚠ 注意：init フックで flush_rewrite_rules() を呼ばない

flush_rewrite_rules() はデータベースへの書き込みを伴う重い処理です。initフック内で毎回実行すると、ページアクセスのたびにリライトルールが再生成され、パフォーマンスが著しく低下します。
テーマやプラグインの有効化・無効化時のみ実行してください。

NG例：init で毎回フラッシュ（絶対にやらない）

// ❌ 毎リクエストで実行される → パフォーマンス低下
add_action( 'init', function() {
    register_post_type( 'news', [ ... ] );
    flush_rewrite_rules(); // ← これが問題
});

// ✅ テーマの場合：init で登録 + after_switch_theme でフラッシュ
add_action( 'init', 'mytheme_register_post_types' );
add_action( 'after_switch_theme', function() {
    mytheme_register_post_types();
    flush_rewrite_rules();
});

// ✅ プラグインの場合：register_activation_hook を使う
register_activation_hook( __FILE__, function() {
    myplugin_register_post_types();
    flush_rewrite_rules();
});

register_post_type() の rewrite 関連パラメータ

register_post_type( 'news', [
    'label'     => 'ニュース',
    'public'    => true,

    // ▼ 個別記事の表示に必要
    'publicly_queryable' => true,  // false だと個別記事が404に

    // ▼ リライトルールの設定
    'rewrite'   => [
        'slug'       => 'news',        // URLのスラッグ
        'with_front' => false,         // パーマリンク接頭辞を含めない
        'pages'      => true,          // ページネーションルールを生成
        'feeds'      => true,          // フィードルールを生成
    ],

    // ▼ アーカイブページの表示に必要
    'has_archive' => true,          // false だとアーカイブが404に
]);

public が内部的に設定するパラメータ

// public => true は以下と同等
'publicly_queryable' => true,  // フロントでクエリ可能か
'show_ui'            => true,  // 管理画面に表示するか
'show_in_nav_menus'  => true,  // ナビメニューに含めるか
'exclude_from_search' => false, // 検索結果に含めるか

// ⚠ public => true でも個別に上書きすると404になる
register_post_type( 'news', [
    'public'             => true,
    'publicly_queryable' => false, // ← これで個別記事が404に！
]);

スラッグを変更して競合を回避

// ❌ 固定ページ「news」と競合
register_post_type( 'news', [
    'rewrite' => [ 'slug' => 'news' ],
]);

// ✅ 方法1：rewrite slug を変更
register_post_type( 'news', [
    'rewrite' => [ 'slug' => 'latest-news' ],
]);
// URL: /latest-news/記事スラッグ/

// ✅ 方法2：競合する固定ページを削除 or スラッグ変更
// 固定ページ「news」→「news-page」に変更

? 確認方法

管理画面の固定ページ一覧で、カスタム投稿タイプと同じスラッグの固定ページがないか確認してください。また、設定 → パーマリンクのカテゴリベースが空欄（デフォルト）の場合、カテゴリスラッグとの競合も起きやすくなります。

httpd.conf で mod_rewrite を有効化

# httpd.conf（Apache設定ファイル）
# 以下の行のコメントを外す（先頭の # を削除）
LoadModule rewrite_module modules/mod_rewrite.so

# AllowOverride を None → All に変更
<Directory "/var/www/html">
    AllowOverride All  # ← None から All に
</Directory>

WordPress標準の .htaccess

# BEGIN WordPress
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
RewriteBase /
RewriteRule ^index.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
</IfModule>
# END WordPress

⚠ サブディレクトリにインストールしている場合

WordPressを /blog/ などのサブディレクトリにインストールしている場合は、RewriteBase を変更する必要があります。
例：RewriteBase /blog/
.htaccessの詳しい書き方は「301リダイレクトの書き方」でも解説しています。

Nginx のリライトルール

location / {
    try_files $uri $uri/ /index.php?$args;
}

プラグイン競合の切り分け手順

functions.php に一時的に追加してリライトルールを確認

// 現在のリライトルールを出力（管理者のみ）
add_action( 'wp_footer', function() {
    if ( ! current_user_can( 'manage_options' ) ) return;

    global $wp_rewrite;
    $rules = $wp_rewrite->wp_rewrite_rules();

    // カスタム投稿タイプ「news」のルールだけフィルタ
    $news_rules = array_filter( $rules, function( $query ) {
        return strpos( $query, 'post_type=news' ) !== false
            || strpos( $query, 'news=' ) !== false;
    });

    echo '<!-- Rewrite Rules for news: ';
    print_r( $news_rules );
    echo ' -->';
});

404ページでマッチしたルールと解析結果を出力

// リクエストの解析結果を出力（一時的なデバッグ用）
add_action( 'template_redirect', function() {
    if ( ! current_user_can( 'manage_options' ) ) return;
    if ( ! is_404() ) return;

    global $wp, $wp_query;

    error_log( '=== 404 Debug =========================' );
    error_log( 'Request URI: ' . $_SERVER['REQUEST_URI'] );
    error_log( 'Matched Rule: ' . $wp->matched_rule );
    error_log( 'Matched Query: ' . $wp->matched_query );
    error_log( 'Query Vars: ' . print_r( $wp_query->query_vars, true ) );
    error_log( '==========================================' );
});

Rewrite Rules Inspector の使い方

1. プラグインをインストール・有効化
2. 管理画面のツール → Rewrite Rulesを開く
3. フィルターボックスにカスタム投稿タイプ名を入力
4. 該当するルールが表示されれば登録は正常
5. ルールがなければ、register_post_type() の設定を見直す

has_archive の設定例

register_post_type( 'news', [
    'public'      => true,

    // ▼ アーカイブページを有効にする
    'has_archive' => true,
    // URL: /news/ でアーカイブ一覧が表示される

    // カスタムスラッグにすることも可能
    // 'has_archive' => 'news-archive',
    // URL: /news-archive/ でアーカイブが表示される

    'rewrite'     => [ 'slug' => 'news', 'with_front' => false ],
]);

テンプレート優先順位

functions.php – ページネーション404の修正

/**
 * カスタム投稿タイプのアーカイブで表示件数を変更
 * メインクエリの件数をテンプレートの表示件数と合わせる
 */
add_action( 'pre_get_posts', function( $query ) {
    // 管理画面・メインクエリ以外は除外
    if ( is_admin() || ! $query->is_main_query() ) {
        return;
    }

    // カスタム投稿タイプ「news」のアーカイブページ
    if ( $query->is_post_type_archive( 'news' ) ) {
        $query->set( 'posts_per_page', 12 );
    }
});

? ポイント

is_main_query() のチェックは必須です。これがないと、サイドバーのウィジェットなどサブクエリにも影響してしまいます。また、管理画面の投稿一覧の件数も変わってしまうため、is_admin() チェックも忘れずに。WP_Queryの条件指定について詳しくは「WP_Queryで複雑な条件検索を実装する方法」を参照してください。

functions.php – 404を防ぐカスタム投稿タイプ登録のベストプラクティス

/**
 * カスタム投稿タイプの登録
 */
function mytheme_register_post_types() {

    $labels = [
        'name'               => 'ニュース',
        'singular_name'      => 'ニュース',
        'add_new'            => '新規追加',
        'add_new_item'       => '新規ニュースを追加',
        'edit_item'          => 'ニュースを編集',
        'view_item'          => 'ニュースを表示',
        'search_items'       => 'ニュースを検索',
        'not_found'          => 'ニュースが見つかりません',
        'not_found_in_trash' => 'ゴミ箱にニュースはありません',
    ];

    $args = [
        'labels'             => $labels,
        'public'             => true,
        'publicly_queryable' => true,       // 明示的に true
        'show_ui'            => true,
        'show_in_rest'       => true,       // ブロックエディタ対応
        'has_archive'        => true,       // アーカイブページ有効
        'hierarchical'       => false,
        'supports'           => [
            'title', 'editor', 'thumbnail', 'excerpt', 'revisions',
        ],
        'rewrite'            => [
            'slug'       => 'news',
            'with_front' => false,          // 接頭辞なし
            'pages'      => true,           // ページネーション
            'feeds'      => true,           // RSSフィード
        ],
        'menu_icon'          => 'dashicons-megaphone',
        'menu_position'      => 5,
    ];

    register_post_type( 'news', $args );
}
add_action( 'init', 'mytheme_register_post_types' );

/**
 * テーマ有効化時にリライトルールをフラッシュ
 */
function mytheme_rewrite_flush() {
    mytheme_register_post_types();
    flush_rewrite_rules();
}
add_action( 'after_switch_theme', 'mytheme_rewrite_flush' );

カスタム投稿タイプの404エラー 対処チェックリスト