webman应用部署失败需系统排查：一查php版本≥7.4及pcntl等扩展是否启用；二查8787端口占用与防火墙放行；三修正项目目录权限与用户归属；四配置systemd服务实现常驻运行；五校验nginx反代proxy_pass、header及超时设置。
如果您在Linux服务器上部署Webman应用，但服务无法正常启动或访问，则可能是由于生产环境配置不满足框架运行要求。以下是针对该问题的系统性排查步骤：
一、PHP环境与扩展检查
Webman依赖特定版本的PHP及若干核心扩展，缺失或版本不匹配将导致启动失败或功能异常。需确认PHP版本不低于7.4，并启用pcntl、posix、openssl、pdo_mysql等扩展。
1、执行php -v命令，验证PHP版本是否为7.4或更高版本。
2、执行php -m命令，检查输出列表中是否包含pcntl、posix、openssl、pdo_mysql等模块。
3、若缺失关键扩展，在Ubuntu/Debian系统中运行sudo apt install php-pcntl php-posix php-openssl php-mysql；在CentOS/RHEL系统中运行sudo yum install php-process php-opcache php-mysqlnd。
4、修改php.ini，确保disable_functions配置项中未禁用pcntl_fork、pcntl_waitpid等函数。
二、端口与防火墙冲突排查
Webman默认监听8787端口（开发模式）或80/443（生产反代），若端口被占用或被防火墙拦截，客户端将无法建立连接。需同步检查本地端口占用状态与系统级网络策略。
1、执行sudo lsof -i :8787命令，确认该端口是否已被其他进程占用。
2、若存在占用进程，记录其PID并执行sudo kill -9 [PID]强制终止。
3、执行sudo ufw status verbose（Ubuntu）或sudo firewall-cmd --list-all（CentOS）检查防火墙规则，确认8787端口（或反代所用端口）已在入站规则中放行。
4、如未放行，执行sudo ufw allow 8787（Ubuntu）或sudo firewall-cmd --permanent --add-port=8787/tcp && sudo firewall-cmd --reload（CentOS）。
三、用户权限与文件所有权修正
Webman常以非root用户（如www-data、nginx或自定义用户）运行，若项目目录、日志路径或socket文件权限不足，将触发Permission denied错误或服务静默退出。
1、确认Webman项目根目录归属：执行ls -ld /www/webman，检查所有者是否为运行用户。
2、若归属不符，执行sudo chown -R www-data:www-data /www/webman（Ubuntu）或sudo chown -R nginx:nginx /www/webman（CentOS）。
3、设置目录权限：执行sudo find /www/webman -type d -exec chmod 755 {} \;，确保目录可遍历。
4、设置文件权限：执行sudo find /www/webman -type f -exec chmod 644 {} \;，并单独对start.php赋予执行权限：sudo chmod +x /www/webman/start.php。
四、服务启动方式适配生产场景
Webman支持常驻内存运行，但在生产环境中直接使用php start.php start -d易因进程管理缺失而意外退出。应采用systemd托管服务，确保崩溃自动重启、日志统一归集。
1、创建systemd服务文件：执行sudo nano /etc/systemd/system/webman.service。
2、写入以下内容（请按实际路径替换WorkingDirectory和ExecStart）：
[Unit]
Description=Webman Service
After=network.target
[Service]
Type=simple
User=www-data
WorkingDirectory=/www/webman
ExecStart=/usr/bin/php /www/webman/start.php start -d
Restart=always
RestartSec=3
StandardOutput=journal
StandardError=journal
[Install]
WantedBy=multi-user.target
3、重载配置并启用服务：执行sudo systemctl daemon-reload && sudo systemctl enable webman && sudo systemctl start webman。
4、验证状态：执行sudo systemctl status webman，确认Active状态为active (running)且无failed字样。
五、Nginx反向代理配置校验
生产环境通常通过Nginx反代Webman HTTP服务，若proxy_pass地址、header转发或超时参数配置错误，将出现502 Bad Gateway或连接中断。
1、检查Nginx虚拟主机配置中location /块是否包含proxy_pass http://127.0.0.1:8787;指令。
2、确认已添加必要header转发：proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme;
3、设置合理超时：proxy_connect_timeout 30s; proxy_send_timeout 30s; proxy_read_timeout 30s;
4、测试配置并重载：执行sudo nginx -t && sudo systemctl reload nginx，确保返回syntax is ok及test is successful。
