正文

WordPress运维老手血泪史，这7个.htaccess重定向变态坑，我赌你全踩过！

程序员老王
程序员老王 V管理员 /239阅读/3评论
0703
此篇文章发布距今已超过119天，您需要注意文章的内容或图片是否可用！

安装环境检测不通过——重定向规则把PHP给“绑架”了

报错现象：
你满心欢喜地上传WordPress安装包，浏览器却直接弹出一段纯文本：
“Your PHP installation appears to be missing the MySQL extension which is required by WordPress.”
或者更诡异的是，你明明装好了LNMP环境，打开安装页面却显示一堆杂乱无章的.htaccess指令内容，像被“泄密”了一样。

WordPress运维老手血泪史，这7个.htaccess重定向变态坑，我赌你全踩过！

WordPress运维老手血泪史，这7个.htaccess重定向变态坑，我赌你全踩过！

原因分析：
这种情况十有八九是.htaccess里某条“伪静态”规则，在安装阶段就强行接管了所有请求，直接把PHP代码当文本暴露了，常见于你手贱复制了生产环境的规则文件，或者安装了某种“全能型”安全插件残留的拦截规则，尤其是当Apache的mod_rewrite模块正常，但WordPress尚未生成默认的.htaccess内容时，任何多余的规则都会让安装检测程序“窒息”。

解决步骤：

  1. 立刻删除或重命名.htaccess文件：
    在WordPress根目录下执行：mv .htaccess .htaccess.bak
    让安装程序在“裸奔”状态下运行。

  2. 刷新安装页面：
    如果还出现文本泄露，检查Apache配置中是否在<Directory>块内启用了AllowOverride All，执行：
    grep -r "AllowOverride" /etc/apache2/
    确保没有AllowOverride None覆盖了网站目录。

  3. 手动创建干净的.htaccess：
    安装完成后，再前往“设置→固定链接”点击保存，WordPress会自动生成标准规则。

  4. 绝杀秘技：
    如果你用Nginx，请立刻去检查伪静态配置，Nginx不认.htaccess，必须将规则写入/etc/nginx/sites-available/你的站点，否则直接404或暴露源码。

数据库连接错误——.htaccess成了“劫匪”，偷换了数据库参数

报错现象：
安装进行到数据库配置页，明明wp-config.php里的数据库名、用户名、密码都正确，系统却报：
“Error establishing a database connection”
你再三核对，甚至登录phpMyAdmin都能连上，但WordPress死活不认。

原因分析：
如果你在.htaccess里启用了mod_env或SetEnv指令，用来强制设置某些环境变量（比如为了调试隐藏错误），这些变量可能会覆盖掉PHP的正常数据库连接参数，更隐蔽的情况是，某些安全插件会在.htaccess中添加RewriteRule拦截包含wp-config.php的请求，导致数据库认证过程被中途“撕票”。

解决步骤：

  1. 检查.htaccess中所有SetEnv和RewriteRule：
    执行：grep -n "SetEnv\|RewriteRule" .htaccess
    重点排查是否有类似：
    SetEnv DB_NAME "fake_db"
    或
    RewriteRule ^wp-config\.php - [F,L]

  2. 临时移除所有非WordPress原生的规则：
    只保留# BEGIN WordPress到# END WordPress，其余全部注释或删除。

  3. 添加调试代码：
    在wp-config.php中，require_once(ABSPATH . 'wp-settings.php');之前加入： 

    echo 'DB_NAME: ' . DB_NAME . '<br>';
echo 'DB_USER: ' . DB_USER . '<br>';

    如果输出显示的值与你设置的不同,说明环境变量被覆盖了。

  4. 终极方案：
    删除.htaccess后，重新生成固定链接，然后不要手贱再往里“加戏”。

500内部服务器错误——.htaccess把自己写成了“死循环”

报错现象：
你刚修改完.htaccess，网站立刻崩成一团白屏，浏览器返回HTTP 500错误，刷新无济于事，甚至后台也进不去，Apache错误日志里刷满：
Request exceeded the limit of 10 internal redirects due to probable configuration

原因分析：
这是最经典的.htaccess白痴错误，当你在RewriteCond和RewriteRule里使用了过于宽泛的匹配条件，导致规则无限循环。 

RewriteRule ^(.*)$ /index.php/$1 [L]

这条规则会将任何请求都重写回index.php，但重写后的请求又会匹配到自身，导致循环重定向，直到Apache触发内部防护机制。

解决步骤：

  1. 立即用FTP或SSH重命名.htaccess：
    mv .htaccess .htaccess.bak
    网站立刻恢复正常。

  2. 逐条检查规则：
    避免使用作为匹配所有路径的规则，正确的WordPress伪静态规则应该是： 

    RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]

    关键点在于用!-f和!-d条件过滤掉真实存在的文件和目录。

  3. 利用在线工具验证规则：
    将规则粘贴到[htaccess.madewithlove.com]测试，看看是否会产生无尽的“State: Redirect”步骤。

  4. 备份当前的.htaccess：
    以后每次修改前，先备份：cp .htaccess .htaccess.backup.$(date +%Y%m%d%H%M)

白屏死机——.htaccess误删了PHP处理权限

报错现象：
访问首页和所有页面都是纯粹的白屏，没有错误提示，F12的Console里也没有任何HTTP错误，你尝试访问wp-admin，同样是死寂的白。

原因分析：
这种白屏往往不是PHP语法错误，而是.htaccess里的<FilesMatch>或<IfModule mod_php.c>指令错误地限制了PHP文件的执行权限。 

<FilesMatch "\.php$">
    SetHandler application/x-httpd-php-source
</FilesMatch>

这条指令本应让PHP文件以源码方式显示,但如果你手滑把SetHandler写成了None或text/plain，PHP就变成了纯文本，浏览器直接“哑巴”了。

解决步骤：

  1. 禁用.htaccess再测试：
    重命名后，如果白屏消失，说明问题在.htaccess里。

  2. 检查所有<Files>和<FilesMatch>块：
    搜索SetHandler、ForceType、AddHandler等关键词，正常的设置应该是： 

    <FilesMatch "\.php$">
    SetHandler application/x-httpd-php
</FilesMatch>

  3. 排除缓存插件干扰：
    如果你用了W3 Total Cache或WP Super Cache，它们生成的.htaccess规则极其臃肿，删除.htaccess后，在插件设置里重新生成即可。

  4. 检查PHP-FPM的socket路径：
    如果你在.htaccess里写入了ProxyPassMatch或fcgi://的规则，确认路径与php-fpm配置一致，执行：
    ls -al /var/run/php/ 查看php7.4-fpm.sock是否存在。

插件冲突导致异常——.htaccess被插件“下毒”

报错现象：
你安装了一个“全能安全”或“防盗链”插件，网站立刻开始抽风：图片无法加载、页面CSS丢失、后台登录跳转到乱七八糟的域名，禁用插件后问题依旧。

原因分析：
这类插件最喜欢干的事就是在.htaccess里“拉屎”，它们会写入诸如： 

RewriteCond %{HTTP_REFERER} !^$
RewriteCond %{HTTP_REFERER} !^http(s)?://(www\.)?你的域名.com [NC]
RewriteRule \.(jpg|jpeg|png|gif)$ - [F,NC,L]

这原本是防盗链规则,但如果正则写错了或者插件的逻辑有Bug，就会误伤自己站点的资源，更恶心的是，禁用插件后，插件不会自动清理这些规则。

解决步骤：

  1. 暴力清除所有非原生规则：
    保留# BEGIN WordPress到# END WordPress，其他全部删除。

  2. 查找“脏数据”来源：
    搜索插件名关键词，
    grep -i "PluginName\|secu|firewall" .htaccess

  3. 恢复默认规则：
    如果怕删错，就去[WordPress官网Codex]复制标准.htaccess内容。

  4. 彻底断根：
    在插件的“设置”页面，寻找类似“Clean Up .htaccess”的按钮，如果没有，卸载插件后手动检查。

  5. 建立防篡改机制：
    在wp-config.php中添加： 

    define('DISALLOW_FILE_EDIT', true);

    但这只能防止插件修改文件,不能阻止已经发生的破坏。

自动更新失败回滚——.htaccess在更新时被锁死

报错现象：
WordPress后台提示有核心更新，你点了“自动更新”，进度条走到100%后，突然显示“更新失败：目标目录已被占用”或“无法创建临时文件”，回滚后，网站功能正常但总有奇怪的URL发疯。

原因分析：
最常被忽略的原因是.htaccess里有一条RewriteRule拦截了wp-content/upgrade/或wp-admin/includes/目录的写入请求，比如某些“终极防御”插件写的规则： 

RewriteRule ^wp-content/upgrade/ - [F,L]

这原本是为了防止恶意上传,但同样阻挡了WordPress自动更新机制，另一个常见原因是.htaccess文件权限设为444（只读），导致更新程序无法写入新规则。

解决步骤：

  1. 检查文件权限：
    ls -la .htaccess
    如果显示-r--r--r--，执行：
    chmod 644 .htaccess

  2. 删除.htaccess中所有包含upgrade或update的规则：
    sed -i '/upgrade/d' .htaccess
    不要用Windows记事本编辑，否则会插入BOM头。

  3. 手动触发更新：
    在wp-config.php中添加： 

    define('FS_METHOD', 'direct');

    强制WordPress使用直接文件系统访问。

  4. 清理更新残留：
    删除wp-content/upgrade/目录下的所有文件，然后重新尝试自动更新。

登录页面重定向循环——.htaccess把wp-admin“迷路”了

报错现象：
输入用户名密码后，页面无限刷新，地址栏在/wp-login.php和/wp-admin/之间疯狂跳转，最终浏览器提示“该网页无法正常运作”，清除Cookie和缓存后，情况依旧。

原因分析：
重定向循环的罪魁祸首通常是.htaccess里伪静态规则与WordPress的cookie验证机制冲突，常见于： 

RewriteCond %{HTTPS} !=on
RewriteRule ^wp-admin https://%{HTTP_HOST}%{REQUEST_URI} [R=301,L]

这条规则强制登录页使用HTTPS,但如果你的SSL证书没配置好，或者站点地址设置里用了http://，就会导致无限跳转，另一个元凶是RedirectMatch指令： 

RedirectMatch 301 ^/wp-admin/ /wp-login.php

如果目标URL本身又匹配了该规则,循环形成。

解决步骤：

  1. 临时关闭HTTPS重定向：
    注释掉.htaccess里所有与HTTPS和wp-admin相关的RewriteRule。

  2. 检查站点地址一致性：
    在数据库中执行： 

    SELECT * FROM wp_options WHERE option_name IN ('siteurl', 'home');

    确保两条记录的协议一致（都是https://或都是http://）。

  3. 清除浏览器完全缓存：
    不要只点“清空缓存”，要用“清除浏览数据”并勾选“Cookie和其他站点数据”。

  4. 添加调试头：
    在wp-config.php的require_once之前加入： 

    define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);

    检查wp-content/debug.log里是否有redirect相关的错误。

  5. 终极修复：
    删除.htaccess，登录后台后，在“设置→常规”里确保站点地址正确，然后保存固定链接重新生成规则，如果用的是Nginx，去检查伪静态配置里是否重复了try_files指令。

老手的肺腑之言：
.htaccess是一把双刃剑，你越是往里面塞规则，以后排查起来就越痛苦，我见过最疯的.htaccess有300多行，里面夹杂着8个不同插件留下的“杰作”，如果你实在喜欢折腾，请记住三个原则：

  1. 每次修改前备份。
  2. 只保留WordPress原生的规则。
  3. 不要相信任何插件帮你管理.htaccess。

当你被.htaccess逼到崩溃时，去喝杯星巴克，回来直接删除它，相信我，2010年之前的那些花里胡哨的RewriteRule，在2024年的Nginx+Redis架构下，全是累赘。