移除.html/.php后缀：.htaccess配置无效问题排查求助

你配置的移除.html后缀的.htaccess规则如下：

RewriteEngine on

RewriteCond %{THE_REQUEST} /([^.]+)\.html [NC]
RewriteRule ^ /%1 [NC,L,R]

RewriteCond %{REQUEST_FILENAME}.html -f
RewriteRule ^ %{REQUEST_URI}.html [NC,L]

该规则本地测试有效，但上传至线上后无法生效，且已确认httpd.conf中AllowOverride设为ALL，可按以下步骤排查：

• 确认线上服务器已启用mod_rewrite模块
  多数共享主机默认未开启该模块，可通过phpinfo页面查看是否存在mod_rewrite条目，或联系主机商确认。若为独立服务器，执行命令a2enmod rewrite启用模块，之后重启Apache服务。

• 检查.htaccess文件的位置与命名
  文件必须放置在网站根目录，且文件名严格为.htaccess（注意开头的英文点号）。部分FTP工具会隐藏此类隐藏文件，需确认文件已成功上传，未被重命名或遗漏。

• 适配线上环境的URL结构
  若线上网站部署在子目录中，当前根目录规则会失效，需添加RewriteBase指定路径：

  RewriteBase /your-subdirectory/
  

  将your-subdirectory替换为实际子目录名称，再重新测试规则。

• 排查规则冲突
  线上.htaccess文件可能包含其他Rewrite规则（如CMS自带的路由规则），这些规则可能与你的后缀移除规则冲突。可暂时注释其他规则，仅保留你的规则测试，确认是否为冲突导致。

• 补充.php后缀处理规则
  你当前的规则仅处理.html后缀，若需同时移除.php后缀，需补充对应规则：

  # 跳转.php后缀的请求到无后缀地址
  RewriteCond %{THE_REQUEST} /([^.]+)\.php [NC]
  RewriteRule ^ /%1 [NC,L,R]
  
  # 内部重写无后缀请求到对应.php文件
  RewriteCond %{REQUEST_FILENAME}.php -f
  RewriteRule ^ %{REQUEST_URI}.php [NC,L]
  

• 清除缓存
  线上服务器可能存在CDN或服务器缓存，修改.htaccess后需清空对应缓存；同时使用浏览器无痕模式测试，避免本地缓存影响结果。

• 查看Apache错误日志
  直接查看Apache错误日志（独立服务器一般路径为/var/log/apache2/error.log，共享主机可在主机控制面板查看），日志中会记录Rewrite规则的语法错误、文件缺失等问题，能快速定位故障原因。

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