Ubuntu22.04部署OpenLiteSpeed+WordPress出现404错误求助

一、确认虚拟主机根目录与文件路径一致性 #

你的WordPress index.php 存储在 /var/www/html/wordpress 目录下，先核对OpenLiteSide虚拟主机配置：

• 登录后台进入对应虚拟主机的「General」标签，检查「Document Root」是否准确设置为 /var/www/html/wordpress
• 修复目录权限，执行命令：

  sudo chown -R www-data:www-data /var/www/html/wordpress
  sudo chmod -R 755 /var/www/html/wordpress
  

二、验证PHP外部应用配置有效性 #

OpenLiteSpeed的PHP外部应用配置是核心，按以下步骤排查：

1. 确认PHP二进制文件路径：
   适配OpenLiteSpeed的PHP8.0默认路径为 /usr/local/lsws/lsphp80/bin/lsphp，用命令验证是否存在：

   ls -l /usr/local/lsws/lsphp80/bin/lsphp
   

   若不存在，执行 which lsphp80 查找准确路径，将其填入「Server Configuration」→「External App」的「Command」字段。
2. 验证PHP是否生效：
   在WordPress根目录新建 info.php 文件，内容为：

   <?php phpinfo(); ?>
   

   访问 http://你的IP/info.php，若显示PHP信息页面，说明配置有效；若仍404，需关联虚拟主机与PHP应用。
3. 关联虚拟主机与PHP应用：
   进入虚拟主机的「Script Handler」标签，添加规则：
   • Suffixes填 php
   • Handler选择你配置的PHP外部应用（如lsphp80）
     保存后重启服务：

   sudo systemctl restart lsws
   

三、检查WordPress固定链接与Rewrite规则 #

1. 若能访问 http://你的IP/wp-admin，进入「设置」→「固定链接」，选择「朴素」模式，保存后刷新前端测试。
2. 若使用其他固定链接模式，需启用Rewrite：
   进入虚拟主机的「Rewrite」标签，勾选「Enable Rewrite」，填入以下规则：

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

   保存后重启OpenLiteSpeed。

四、安装必要PHP扩展 #

适配OpenLiteSpeed的PHP8.0需安装WordPress核心扩展，执行命令：

sudo apt install lsphp80-common lsphp80-mysql lsphp80-curl lsphp80-gd lsphp80-mbstring lsphp80-xml lsphp80-zip

安装完成后重启服务。

五、通过日志定位问题 #

若以上步骤无效，查看OpenLiteSpeed错误日志：

sudo tail -f /usr/local/lsws/logs/error.log

访问网站时观察日志输出，根据具体错误信息进一步排查。

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