.htaccess ErrorDocument规则不生效于带.php后缀的无效URL

问题核心原因 #

Apache的mod_php模块会优先处理.php后缀的请求，当目标文件不存在时，会直接返回内置的"File Not Found"空白页面，绕过了你配置的ErrorDocument 404规则。

可行的.htaccess调整方案 #

把你当前注释掉的无效.php处理规则替换成以下内容，确保这段规则放在所有手动301重定向规则之后：

# 处理不存在的.php文件，转发到自定义404并保留404状态码
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_URI} \.php$
RewriteRule ^ /404-error.php [L,R=404]

规则说明 #

• RewriteCond %{REQUEST_FILENAME} !-f：确认请求的文件实际不存在
• RewriteCond %{REQUEST_FILENAME} !-d：确认请求的目录实际不存在
• RewriteCond %{REQUEST_URI} \.php$：精准匹配所有以.php结尾的请求
• RewriteRule ^ /404-error.php [L,R=404]：转发到你的自定义404页面，R=404标记会让服务器正确返回404状态码，同时保留自定义页面内容，完全不影响现有301重定向规则。

配置位置参考 #

确保规则放在ErrorDocument和手动301重定向之后，示例片段：

ErrorDocument 404 /404-error.php

# 301 Redirects
Redirect 301 /old-page.php /new-page.php
# ...其他自定义重定向规则

# 处理不存在的.php文件
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_URI} \.php$
RewriteRule ^ /404-error.php [L,R=404]

之前尝试失败的原因 #

1. 第一个规则用R=301强制跳转，把所有无效请求都改成了301重定向，覆盖了原有自定义重定向，还错误地将404状态码改成了301。
2. 第二个规则错误地用R=404跳转到首页，R标记仅适用于3xx系列重定向状态码，404属于客户端错误，这么写逻辑混乱还干扰了原有重定向。
3. 第三个规则直接转发到首页但未设置状态码，导致服务器返回200，不符合SEO对无效页面的状态码要求。

验证方法 #

访问任意无效.php URL（比如https://www.mywebsite.com/broken.php），检查三点：

• 页面显示你的自定义404内容
• 浏览器开发者工具的网络请求状态码为404
• 原有301重定向规则依然正常生效

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