seat故障排除——EVE Online军团管理系统

这是seat系列的第三篇文章，第一篇的链接在这：

从零开始搭建一个军团（联盟）SeAT——EVE Online军团管理系统http://t.csdnimg.cn/xGeHC本片文章会介绍一些当seat运行出现故障时应该如何排查并修理

零：及时备份服务器快照和数据库

如你所见，在进行无尽的故障排查之前，最好的做法就是防患于未然，及时备份服务器快照和数据库，这能在发生严重故障之后及时的恢复服务。

一：启用seat的调试模式

在有些时候，访问seat网页会出现错误提示，但不会显示错误信息

这时我们需要启用seat的调试模式让它输出完整的错误信息。

无论是通过docker安装的seat还是裸机安装，调试模式的选项均在seat的.env配置文件中

对于裸机安装

cd /var/www/seat
vim .env

对于docker安装

cd /opt/seat-docker
vim .env

在配置文件中找到

APP_DEBUG=false

将其值改为true即可开启调试模式。

裸机安装的seat在更改并保存后会即刻应用更改，而对于docker安装，则需要重启docker容器

在完成调试后，请及时关闭调试模式

二：检查日志文件

无论应用程序是否处于调试模式，日志始终写入两个日志文件之一。应用程序日志转到 Laravel 框架日志文件。发送到 ESI 的 API 请求存储在 Eseye 日志文件中。该目录可在文件夹中找到。

/var/www/seat/storage/logs

裸机安装

以下命令将显示一天内产生的日志文件

应用日志：

tail -f /var/www/seat/storage/logs/laravel-$(date +%Y-%m-%d).log

Esye / ESI 日志：

tail -f /var/www/seat/storage/logs/eseye-$(date +%Y-%m-%d).log

docker安装

首先我们需要先进入容器

对于seat 4.x

docker-compose exec seat-web sh

对于seat 5.x

docker compose exec front sh

然后使用裸机安装的命令即可查看日志

tail -f /var/www/seat/storage/logs/laravel-$(date +%Y-%m-%d).log
tail -f /var/www/seat/storage/logs/eseye-$(date +%Y-%m-%d).log

三：自动诊断工具

seat内置了一个诊断命令，可以执行许多自检以帮助诊断问题。

裸机安装

在seat的工作目录下运行命令以启动诊断工具

cd /var/www/seat

su -c 'php artisan seat:admin:diagnose' -s /bin/sh www-data

docker安装

cd /opt/seat-docker

对于seat 4.x

docker-compose exec seat-web php artisan seat:admin:diagnose

对于seat 5.x

docker compose exec front php artisan seat:admin:diagnose