Ubuntu dist-upgrade后Freescout服务器的Apache无法正常显示网页

Hey，我完全懂你这种刚把Freescout弄好能用，升级个包就翻车的郁闷！别慌，咱们一步步来排查，把你的客服系统找回来～

第一步：先确认Apache服务状态和虚拟主机配置 #

首先得确保Apache没挂，而且Freescout的虚拟主机还在生效：

• 检查Apache运行状态：

  sudo systemctl status apache2
  

  如果显示active (running)就没问题，要是有报错先记下来。
• 确认Freescout的虚拟主机是否启用：
  安装脚本一般会生成类似freescout.conf的虚拟主机文件，执行命令启用（如果没启用的话）：

  sudo a2ensite freescout.conf
  

• 重启Apache让配置生效：

  sudo systemctl restart apache2
  

第二步：检查站点根目录是否指向正确 #

Freescout是基于Laravel框架的，必须把Apache的DocumentRoot指向它的public目录，不然就会显示文件索引页。

• 打开虚拟主机配置文件：

  sudo nano /etc/apache2/sites-available/freescout.conf
  

• 找到DocumentRoot这一行，确认它是指向Freescout的public文件夹，比如：

  DocumentRoot /var/www/freescout/public
  

  如果不是，修改后按Ctrl+O保存，Ctrl+X退出，然后重启Apache。

第三步：确保Apache启用了mod_rewrite模块 #

Laravel的路由依赖这个模块，升级可能不小心给禁用了？

• 启用模块：

  sudo a2enmod rewrite
  

• 重启Apache：

  sudo systemctl restart apache2
  

第四步：修复文件权限问题 #

系统升级可能改变了Freescout文件的所有者或权限，导致Apache没法读写：

• 把Freescout目录的所有者改成Apache的运行用户www-data：

  sudo chown -R www-data:www-data /var/www/freescout
  

• 给存储和缓存目录加写权限（Freescout需要这个来生成日志和缓存）：

  sudo chmod -R 775 /var/www/freescout/storage /var/www/freescout/bootstrap/cache
  

第五步：查看日志找具体报错线索 #

如果上面几步都没用，就得看日志找问题了，这是新手排查的关键：

• Apache错误日志（看有没有权限、模块缺失之类的报错）：

  sudo tail -f /var/log/apache2/error.log
  

  刷新一下网页，看看日志里蹦出什么错误信息。
• Freescout自身的日志（在它的存储目录里）：

  cat /var/www/freescout/storage/logs/laravel.log
  

  这里会记录应用层面的错误，比如数据库连接、依赖缺失等。

第六步：检查PHP版本和必要模块 #

升级可能影响PHP的版本或已安装的模块，Freescout需要这些核心模块才能运行：

• 先看当前PHP版本：

  php -v
  

  Ubuntu22.04默认是PHP8.1，Freescout是支持这个版本的。
• 安装缺失的PHP模块（如果日志里提示模块不存在）：

  sudo apt install php8.1-mbstring php8.1-xml php8.1-mysqli php8.1-gd php8.1-zip php8.1-intl
  

  安装完重启Apache。

按照这个顺序一步步来，大概率能找到问题所在～

备注：内容来源于stack exchange，提问作者Scott W