.htaccess配置隐藏.html文件扩展名规则不生效问题求助

常见失效原因及排查步骤 #

• 确认Apache重写模块已开启
  该规则依赖mod_rewrite模块，可在站点目录新建phpinfo.php文件，写入<?php phpinfo(); ?>，访问后搜索mod_rewrite确认是否在已加载模块列表。未开启的话，多数主机面板可直接在扩展管理中启用，自行搭建的Debian/Ubuntu系服务器可执行sudo a2enmod rewrite后重启Apache。
• 确认站点配置允许.htaccess解析
  Apache默认可能禁用.htaccess生效，打开站点的VirtualHost配置文件，找到对应站点的<Directory>配置段，确认AllowOverride参数值为All而非None，修改后需重启Apache服务生效。
• 修正规则写法适配更多环境
  你当前使用的规则存在路径匹配兼容问题，部分环境下%{REQUEST_FILENAME}的路径获取逻辑不匹配，推荐替换为以下经过验证的规则，同时额外支持访问带.html后缀的地址自动跳转到无后缀地址：

  RewriteEngine On
  # 带.html后缀的访问自动跳转到无后缀地址
  RewriteCond %{THE_REQUEST} /([^.]+)\.html [NC]
  RewriteRule ^ /%1 [NC,L,R=301]
  # 内部将无后缀路径重写到对应的.html文件
  RewriteCond %{REQUEST_FILENAME} !-d
  RewriteCond %{REQUEST_FILENAME}.html -f
  RewriteRule ^([^.]+)$ $1.html [NC,L]
  

• 排除缓存干扰
  配置修改后需清理浏览器缓存，或使用无痕模式测试，301跳转属于永久缓存，旧规则可能在浏览器本地长期生效导致新配置看不到效果。
• 确认.htaccess文件权限正确
  .htaccess文件权限需设置为644，权限过高时Apache会拒绝读取该文件，导致规则无法加载。

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