WordPress 默认会拦截并重写包含特定关键词（如 artist）的查询参数，导致 URL 被误判为无效路由而返回 404；该问题并非语法或服务器配置错误，而是 WordPress 内部查询变量（query vars）冲突所致。
wordpress 默认会拦截并重写包含特定关键词（如 `artist`）的查询参数，导致 url 被误判为无效路由而返回 404；该问题并非语法或服务器配置错误，而是 wordpress 内部查询变量（query vars）冲突所致。
在将自定义 PHP 程序迁入 WordPress 时，直接使用 $_GET 传递参数（如 ?artist=1&genre=rock）看似合理，但极易触发 WordPress 的查询解析机制异常。根本原因在于：WordPress 将部分字符串视为“保留查询变量”（reserved query vars），例如 artist、author、name、page、s 等——这些变量被核心或主题/插件用于构建主查询（WP_Query）。当你的 URL 中出现 ?artist=1，WordPress 会尝试将其解释为“按作者别名查询”，若当前页面不支持该上下文（如非作者归档页），则路由匹配失败，最终返回 404。
你观察到的 $artist=1 “能加载页面但参数失效”，正是因为添加 $ 后，WordPress 的正则路由解析器不再识别该键名为合法 query var（$artist 不在白名单中），从而跳过内部重写逻辑，使请求勉强抵达模板文件；但此时 $_GET['artist'] 实际未被正确注册，get_query_var('artist') 返回空，且原始 $_GET 数组虽存在该键，却可能因 wp_parse_args() 或 WP::parse_request() 的早期处理被过滤或忽略。
✅ 正确解决方式不是改 URL 符号，而是主动注册自定义查询变量：
// 在主题 functions.php 或插件中添加
function my_register_custom_query_vars($vars) {
$vars[] = 'producer'; // ✅ 替换为非保留词，如 'producer'
$vars[] = 'genre';
$vars[] = 'year';
// ... 其他你用到的 28 个参数（全部显式声明）
return $vars;
}
add_filter('query_vars', 'my_register_custom_query_vars');
随后，在模板中安全获取参数：
// 推荐：使用 get_query_var()（已通过 WordPress 过滤和转义）
$producer = get_query_var('producer', ''); // 第二个参数为默认值
$genre = get_query_var('genre', '');
// 或仍需原始 $_GET（仅当需完整未过滤值时），但务必手动校验：
if (isset($_GET['producer'])) {
$producer = sanitize_text_field($_GET['producer']);
}
⚠️ 注意事项：
-
避免使用 WordPress 保留字：完整保留变量列表见 Codex: Reserved Terms，包括
artist、attachment、category_name、tag、post_type等； -
不要依赖
$_GET直接访问：WordPress 可能因remove_query_arg()、add_rewrite_rule()或安全插件修改全局$_GET； -
重写规则非必需：纯
?key=value参数无需自定义 rewrite rule，注册query_vars即可启用； -
调试技巧：启用
define('WP_DEBUG', true);并检查error_log，或临时在template_redirect钩子中var_dump($wp_query->query_vars);查看实际解析结果。
总结：WordPress 的 404 并非拒绝 GET 参数，而是因参数名触发了内部路由语义冲突。将 artist 改为 producer 有效，本质是绕过了保留字检测——但更健壮的做法是显式注册所有自定义参数名，既符合 WordPress 架构规范，也确保长期兼容性与安全性。
