含错误的PHP WordPress页面代码：固定链接失效问题排查

嘿，作为经常在Stack Overflow帮人排查WordPress问题的老鸟，我来给你拆解下这类问题最常见的几个坑——毕竟固定链接失效这种事儿，十有八九是代码里的小细节没处理好。

1. 自定义查询搞乱了主查询（Main Query） #

这是最常见的问题！很多人图省事用query_posts()来做自定义查询，但这个函数会直接覆盖WordPress的全局主查询变量，导致系统无法正确识别当前页面的类型和对应的固定链接规则。

错误代码示例：

query_posts('category_name=tech');
while (have_posts()) : the_post();
  // 文章内容输出
endwhile;

问题本质：query_posts()会修改$wp_query全局变量，WordPress后续解析permalink时，会误以为当前页面是分类页而非自定义页面，直接导致链接失效。
修复方案：改用WP_Query做自定义查询，用完记得重置查询：

$custom_query = new WP_Query('category_name=tech');
while ($custom_query->have_posts()) : $custom_query->the_post();
  // 内容输出
endwhile;
wp_reset_postdata(); // 重置全局$post变量

2. 自定义重写规则没生效或冲突 #

如果你在代码里手动添加了重写规则，但没正确刷新规则，或者规则和WordPress默认规则冲突，也会导致固定链接匹配失败。

• 错误操作示例：

// 添加自定义重写规则但没刷新
$wp_rewrite->rules['custom-page/([^/]+)/?$'] = 'index.php?pagename=custom-page&slug=$matches[1]';

• 问题：新添加的规则不会自动写入数据库，WordPress根本识别不了。
• 修复：在主题激活或插件激活时调用flush_rewrite_rules()（注意别把这个函数放在模板文件里，会每次加载页面都刷新，拖慢速度）。另外，添加规则时尽量避免和默认规则的路径重复，比如别用post/这种WordPress默认已经占用的前缀。

3. 硬编码URL而非用WordPress内置函数 #

很多人图方便直接写死URL，比如：

echo '<a href="/article/' . get_the_ID() . '">阅读全文</a>';

这种写法在固定链接设置为“朴素”（即?p=123）时没问题，但一旦改成“文章名称”或其他自定义结构，这个硬编码的URL就完全失效了。

正确的做法是用WordPress提供的动态链接函数：

echo '<a href="' . get_permalink(get_the_ID()) . '">阅读全文</a>';
// 或者在循环里直接用
the_permalink();

这些函数会根据你当前的固定链接设置，自动生成正确的URL。

4. 全局变量被意外修改后未恢复 #

如果你的代码里直接修改了$post或$wp_query全局变量，用完之后没恢复，也会导致WordPress无法正确判断当前页面的上下文，进而影响permalink的解析。

比如错误代码：

global $post;
$temp_post = $post; // 临时保存
$post = get_post(123); // 修改全局变量
// 输出内容
// 忘记恢复$post变量！

修复：用完之后一定要把全局变量恢复回去：

global $post;
$temp_post = $post;
$post = get_post(123);
// 内容输出
$post = $temp_post; // 恢复原变量

快速排查步骤 #

• 先检查代码里有没有query_posts()，有就换成WP_Query并重置查询；
• 确认自定义重写规则后是否正确刷新了规则；
• 搜索模板里的硬编码URL，全部替换成get_permalink()或the_permalink()；
• 临时禁用所有插件，切换到默认主题（比如Twenty Twenty-Four），看问题是否消失——如果消失，说明是主题或插件冲突导致的。

内容的提问来源于stack exchange，提问作者João