环境配置步骤

H1>九渊神器单职业战旗版源码安装配置与故障排查指南

确认九渊神器单职业战旗版源码已下载至本地，当前版本为1.2.3，以下为环境配置及常见问题解决步骤。

需准备以下环境组件：

执行以下安装脚本（注意检查权限）：

chmod +x setup.sh
./setup.sh --mode warflag --db-prefix wz

关键参数说明：`–mode warflag`指定单职业战旗模式，`–db-prefix`设置数据表前缀

数据库配置验证

检查数据库连接配置文件：

return [
    'type'      => 'mysql',
    'host'      => '127.0.0.1',
    'port'      => '3306',
    'username'  => 'root',
    'password'  => 'admin',
    'database'  => 'wz_game',
    'charset'   => 'utf8mb4',
    'prefix'    => 'wz_',
];

解决常见数据库错误：500 Internal Server Error时检查错误日志中是否有`2002`（连接错误）或`1064`（SQL语法错误）

启动流程详解

执行启动命令后遇到502 Bad Gateway问题的排查步骤：

1. 检查Nginx配置文件中fastcgi_pass指令是否正确
2. 确认php-fpm进程状态：`ps aux | grep php-fpm`
3. 查看php错误日志：`tail -f /var/log/php7.4-fpm.log`

正确配置启动命令：

php bin/console server:run -d

后台进程监控：`htop`或`top -c`查看php进程CPU占用率

核心模块配置

修改战旗配置文件路径：`config/warflag/warflag.yaml`

enabled: true
max_size: 100
duration: 3600
broadcast_interval: 30

参数说明：`max_size`为战旗最大人数，`duration`为持续时间（秒）

常见故障解决

1. 登录白屏问题

排查步骤：

1. 检查`.env`文件中app_ENV是否为`production`
2. 确认缓存目录权限：`chmod -R 775 var/cache`
3. 查看PHP错误日志定位问题

修复代码示例：

// 修复session写入问题
session_save_path('/var/lib/php/session');
session_start();

2. 战旗数据异常

检查数据表结构是否完整：

SHOW CREATE TABLE wz_game_warflags;
SHOW CREATE TABLE wz_game_players;

修复数据不一致的方法：

php bin/console doctrine:schema:validate
php bin/console doctrine:schema:refresh --force

3. 服务器卡顿

性能优化建议：

1. 开启OPcache：`opcache.enable=1`
2. 调整php配置：`max_execution_time=300`
3. 使用Redis缓存战旗状态

配置示例：

return [
    'redis' => [
        'host'       => '127.0.0.1',
        'port'       => 6379,
        'database'   => 0,
        'timeout'    => 0,
    ],
];