0基础做网站遇到wordpress固定连接404?保姆级建站教程带你搞定
自己不会代码想做网站,结果装好 WordPress,一打开就出现 404 错误?别慌,这在建站过程中特别常见,尤其是用固定连接功能的时候。今天我就用最接地气的方式,从江苏本地的实际案例出发,带你看懂什么是 wordpress 固定连接 404,怎么一步步解决,还有保姆级建站教程,适合从零开始的新手。
需求分析:你真的需要 WordPress 固定连接吗?
很多人以为设置好 WordPress 固定连接后,网站就正常了,其实不然。WordPress 默认是使用 query-string 格式(比如 ?p=123)来访问文章页,但为了 SEO 友好,建议使用 固定连接(Permalink),也就是更简洁的 URL 格式,比如 https://www.example.com/2025/01/01/文章标题。
但是,如果设置不当,就容易出现 404 错误,也就是“页面未找到”的问题。这种情况在本地测试和线上部署时都会出现,尤其在更换服务器或更换主机时,更容易出错。
为什么会出现 wordpress 固定连接 404?
几个常见的原因包括:
- 服务器没有正确配置
.htaccess文件; - 使用的是 Nginx 服务器,而没有设置对应的伪静态规则;
- WordPress 安装目录不是根目录,导致路径不匹配;
- 数据库中存储的 permalink 设置和实际设置不符。
如果你遇到了这个问题,别着急,下面我一步步教你解决。
环境准备:本地测试 vs 线上部署
无论你是本地测试还是准备上线,都要做好基础准备。这里我们以 本地搭建 WordPress 环境 + 上传到服务器 为例,适用于大多数新手。
本地开发环境
如果你在本地做测试,建议使用以下工具:
- XAMPP:集成了 Apache、MySQL 和 PHP,适合 Windows 用户;
- MAMP:适合 macOS 用户;
- WAMP:适合 Windows 用户,与 XAMPP 类似;
- Docker:如果你对容器化技术有兴趣,可以试试。
确保你的本地环境安装了 Apache 或 Nginx,MySQL 以及 PHP(建议 7.4 以上版本),并正确配置了 WordPress。
服务器环境准备
如果你要上线,需要:
- 域名:可以去阿里云、腾讯云等平台注册;
- 服务器:推荐使用 LNMP(Linux + Nginx + MySQL + PHP);
- SSL 证书:建议用 Let’s Encrypt 免费申请;
- 备案:如果是国内服务器,需要进行 ICP 备案(江苏地区需要找江苏本地的 IDC 提供商)。
核心步骤:设置 WordPress 固定连接并避免 404 错误
设置 WordPress 固定连接其实很简单,但在部署过程中如果没注意,就容易出错。
第一步:在 WordPress 后台设置固定连接
- 登录 WordPress 管理后台;
- 点击“设置” -> “固定连接”;
- 选择你想要的格式,比如“文章名”或者“自定义结构”;
- 设置完成后,点击“保存更改”。
注意:如果你选择的是“自定义结构”,记得按照格式写入类似 /%year%/%monthnum%/%postname%/ 的格式。
第二步:检查 .htaccess 文件
WordPress 默认会自动创建 .htaccess 文件,但有时它可能被误删或者配置错误。你可以通过 FTP 或者文件管理器进入 WordPress 安装目录,查看是否存在 .htaccess 文件。
如果不存在,可以在 WordPress 后台的“固定连接”页面中,点击“保存更改”按钮,WordPress 会自动创建。
如果存在但内容错误,你可以在 .htaccess 文件中手动输入以下内容:
# BEGIN WordPress
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
</IfModule>
# END WordPress
第三步:检查服务器是否支持 mod_rewrite
如果你使用的是 Apache 服务器,需要确保 mod_rewrite 模块已启用。可以通过以下命令检查:
sudo a2enmod rewrite
sudo systemctl restart apache2
如果你使用的是 Nginx 服务器,那么需要配置伪静态规则。
Nginx 伪静态规则示例
如果你用的是 Nginx,可以参考以下配置:
location / {try_files $uri $uri/ /index.php?$args;
}
将以上内容添加到你的 Nginx 配置文件(通常位于 /etc/nginx/sites-available/)中,然后重启 Nginx:
sudo nginx -t
sudo systemctl restart nginx
第四步:检查 WordPress 安装路径
如果你的 WordPress 安装路径不是根目录(例如 /var/www/html/wordpress/),那么 .htaccess 中的 RewriteBase 也需要相应调整,例如:
RewriteBase /wordpress/
代码/配置示例:常见错误排查与修复
以下是一些常见的 wordpress 固定连接 404 问题以及对应的修复方案。
问题 1:URL 路径不匹配
症状:设置固定连接后,访问 https://www.example.com/2025/01/01/文章标题 会出现 404 错误。
解决方法:
- 检查 WordPress 安装路径是否和
.htaccess中的RewriteBase匹配; - 如果你的 WordPress 安装在子目录,比如
https://www.example.com/blog/,那么.htaccess中的RewriteBase应该设置为/blog/; - 如果你使用的是 Nginx,确保
location匹配路径正确。
问题 2:服务器未启用 mod_rewrite
症状:设置好固定连接后,仍然访问不到页面。
解决方法:
- 对于 Apache 服务器,检查是否启用了
mod_rewrite; - 执行命令
sudo a2enmod rewrite并重启 Apache; - 对于 Nginx,确保配置文件中的
try_files语法正确。
问题 3:.htaccess 被 WordPress 自动修改
症状:你手动修改了 .htaccess,但 WordPress 会自动覆盖它。
解决方法:
- 在 WordPress 后台,进入“设置” -> “固定连接”;
- 点击“保存更改”按钮,WordPress 会自动更新
.htaccess文件; - 如果你手动编辑了
.htaccess,可以先备份再修改。
常见报错:你可能遇到的 wordpress 固定连接 404 类问题
报错 1:404 Not Found
原因:路径不匹配,服务器无法找到页面。
解决方法:
- 确保
.htaccess文件正确配置; - 检查 URL 中是否有拼写错误;
- 确保 WordPress 安装目录路径正确。
报错 2:403 Forbidden
原因:权限问题,服务器不允许访问该文件或目录。
解决方法:
- 检查
.htaccess文件是否有权限错误; - 检查目录权限,确保 Apache 或 Nginx 用户有权限访问 WordPress 文件夹;
- 你可以运行以下命令设置权限:
sudo chown -R www-data:www-data /var/www/html
sudo find /var/www/html -type d -exec chmod 755 {} \;
sudo find /var/www/html -type f -exec chmod 644 {} \;
报错 3:500 Internal Server Error
原因:服务器内部错误,可能是 .htaccess 文件中有语法错误。
解决方法:
- 检查
.htaccess文件是否被误写; - 尝试删除
.htaccess文件,然后在 WordPress 后台重新生成; - 如果问题依旧,可以尝试使用默认的
.htaccess文件内容。
小结:从零到一的 wordpress 固定连接 404 解决指南
如果你是刚入行的新手,想要自己动手建站,但又对代码一无所知,那么 WordPress 是一个非常好的起点。设置 wordpress 固定连接虽然看起来简单,但实际部署过程中容易出错,特别是对于刚接触建站的人来说。
通过本文,我们已经了解了:
- 为什么会出现 wordpress 固定连接 404;
- 如何在本地和服务器上设置 WordPress;
- 如何检查和修复
.htaccess文件; - 常见报错的解决方法。
只要你按照步骤一步步来,即使是 0 基础的新手,也可以顺利解决这些问题,最终搭建出一个功能正常、SEO 友好的网站。