hyperf 裸机部署需绕过容器假设：修复 proc_open 标准流继承、调整 ulimit -u ≥128、禁用 docker.php、适配 systemd type=simple+journal 日志、--no-dev 优化自动加载、调低连接池 max_idle_time 并启用 tcp_keepalive。
Hyperf 默认推荐容器化部署，但如果你的生产环境不允许用 Docker（比如老 IDC 机房、强管控的金融私有云、或运维流程禁止容器），直接在宿主机跑 php bin/hyperf.php start 是可行的，但必须绕过容器带来的默认假设——尤其是配置加载顺序、进程管理、信号处理和依赖隔离问题。
为什么 bin/hyperf.php start 在裸机上会卡住或崩溃
Hyperf 启动脚本默认假定运行在容器中：它依赖 proc_open 启动子进程时设定了 suppress_errors=true，且未显式关闭 stdin/stdout/stderr 的继承；在无容器的 systemd 或 supervisord 下，若未重定向标准流，主进程会因等待 stdin 输入而挂起。同时，signal 处理器在非容器环境下对 SIGTERM 响应不及时，导致平滑退出失败。
- 检查是否出现
PHP Warning: proc_open(): fork failed - Cannot allocate memory：不是内存不足，而是 ulimit -u（用户进程数）被限制太低，Hyperf 默认启 4 个 worker 进程 + manager + reload + timer，至少需ulimit -u 128 - 确认
config/autoload/processes.php中所有enable为true的进程都已适配非容器信号模型，尤其Hyperf\Process\ProcessManager需手动设置stdIn为null - 禁用
docker相关配置项：删除或注释config/autoload/docker.php（如果存在），避免DockerManager尝试调用docker ps
如何让 systemd 正确管理 Hyperf 主进程
systemd 不是简单包装 php bin/hyperf.php start 就能工作的——它需要明确的进程模型、正确的 Type 设置，以及对 stdout/stderr 的主动接管。
- 使用
Type=simple，不要用forking：Hyperf 主进程不 double-fork，forking会导致 systemd 误判主进程退出 - 必须设置
StandardOutput=journal和StandardError=journal，否则日志丢失，且Restart=on-failure无法捕获崩溃 - 添加
Environment="HYPERF_ENV=prod"和Environment="APP_ENV=prod"，避免因环境变量缺失导致配置加载错误 -
ExecStart要绝对路径：例如/usr/bin/php /opt/app/bin/hyperf.php start，不能用~或相对路径
composer install --no-dev 在裸机部署时的陷阱
Hyperf 的 dev 依赖里包含大量调试工具（如 hyperf/tracer、hyperf/testing），它们在生产环境不仅浪费内存，还可能触发自动加载冲突或未声明的扩展依赖（比如 pcntl 在某些 PHP SAPI 下不可用）。
- 务必加
--optimize-autoloader --classmap-authoritative：否则composer/autoload_classmap.php会漏掉部分 runtime 生成类（如Proxy类），导致Class not found - 检查
config/autoload/dependencies.php是否引用了仅 dev 环境注册的类（如Hyperf\Devtool\GeneratorCommand），这些类在--no-dev下不存在，会引发ClassNotFoundException - 运行
php bin/hyperf.php di:dump前，确保di配置中没有指向dev目录下的文件路径
为什么 redis 和 mysql 连接偶尔超时，但在 Docker 里没问题
裸机部署时，DNS 解析、TCP keepalive、连接池复用行为与容器内不同：宿主机网络栈更“原始”，Hyperf 默认的 pool 配置（如 max_idle_time=60）在长连接不稳定时反而加剧连接泄漏。
- MySQL：将
max_idle_time从 60 降为 30，同时在pool配置中显式设reuse为true，避免短连接反复握手 - Redis：禁用
lazy模式（lazy=false），防止首次调用时才建连，导致请求级超时 - 统一加
tcp_keepalive=1到数据库 DSN（如mysql:host=10.0.1.5;port=3306;tcp_keepalive=1），让内核主动探测连接存活
裸机部署 Hyperf 最容易被忽略的点是信号链路完整性：从 systemd 发送 SIGTERM → PHP 接收 → Hyperf 的 SignalHandler 拦截 → 各 worker 主动 close → manager 等待全部退出。任一环节断开（比如某 worker 忘记 pcntl_signal_dispatch()），都会导致进程残留或响应中断。建议上线前用 kill -TERM $(pgrep -f "hyperf.php start") 手动测试退出流程是否干净。
