.htaccess无扩展名访问文件时404错误规则失效问题

问题分析 #

当前配置中，访问不存在的无扩展名路径（如example.com/home1）时，RewriteRule会将请求重写为home1.php，但由于该文件不存在，Apache直接返回默认的“File not found”错误，未触发自定义ErrorDocument规则。原因是重写操作先于404错误处理执行，且未校验目标文件的存在性。

解决方案 #

修改.htaccess中的重写规则，增加对目标PHP文件存在性的检查，仅当对应的.php文件存在时才执行重写。调整后的完整配置如下：

RewriteEngine On 
DirectoryIndex home.php 
Options -Indexes 
Options -MultiViews
Options +FollowSymLinks

# 仅当对应的PHP文件存在时，才重写无扩展名请求
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME}.php -f
RewriteRule ^([^\.]+)$ $1.php [L]

ErrorDocument 404 /404.php
ErrorDocument 403 /403.php

关键修改说明 #

1. 新增条件RewriteCond %{REQUEST_FILENAME}.php -f：检查请求路径拼接.php后是否为存在的文件，满足条件才执行重写。
2. 移除PT标志：PT（Pass Through）用于传递路径给其他模块，此处无需使用，保留L（Last）标志确保规则执行后停止后续重写。
3. 简化ErrorDocument路径：用相对路径/404.php替代绝对URL，避免额外跳转，同时适配域名变更场景。

效果验证 #

• 访问存在的无扩展名路径（如example.com/home）：正常重写为home.php并返回内容。
• 访问不存在的带扩展名文件（如example.com/home1.php）：触发自定义404页面。
• 访问不存在的无扩展名路径（如example.com/home1）：因home1.php不存在，重写规则不执行，Apache直接识别为404错误，触发自定义404页面。

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