Webman 集成 ThinkORM 的核心难点在于初始化时机、模型继承路径和连接生命周期管理。必须使用 support hinkModel 而非 thinkModel，配置中 hostname 类型需与 deploy 模式严格匹配，动态切库应避免重复调用 Db::setConfig，PHP 8.4+ 需手动初始化并添加心跳。
Webman 集成 ThinkORM 不是“装完就能用”，关键在初始化时机、模型继承路径和连接生命周期这三处。装错包、继承错类、动态切库不释放，任一环节出问题都会导致 Class not found、Array to string conversion 或数据库连接数疯涨。
为什么 use thinkModel 会报错，必须用 support hinkModel
Webman 的 webman/think-orm 插件做了类名别名映射，真实加载的是 support hinkModel，而非原生 ThinkPHP 的 thinkModel。即使你已安装 topthink/think-orm，只要模型里写 use thinkModel，运行时就找不到类。
- 正确写法：
use support hinkModel;+class User extends Model - 错误写法：
use thinkModel;（这是 ThinkPHP 原生项目用法） - 命令行生成模型时，若项目中同时存在
illuminate/database，需加tp参数：php webman make:model User tp，否则默认按 Eloquent 规则生成 - 检查
composer.json中是否声明了模型目录自动加载："autoload": {"psr-4": {"app\model\": "app/model/"}}，改完记得运行composer dump-autoload
config/thinkorm.php 的 hostname 字段不能乱写类型
插件自动生成的配置文件常把 hostname 写成字符串（如 '127.0.0.1'），这仅适用于单库；一旦启用主从（'deploy' => 1），就必须改为数组，否则运行时报 Array to string conversion，错误堆栈直指 PDOConnection.php:338。
Webman 2.2.0版本强化了 TCP/UDP 服务支持，优化路由组管理，并增强异步任务处理能力。结合协程与连接池技术，Webman 能轻松应对高并发场景，适用于网站、接口服务、即时通讯、物联网及游戏开发，兼具高性能、灵活扩展与稳定可靠，是多场景 PHP 服务开发的理想选择。
- 单库模式：
'hostname' => '127.0.0.1'，且必须确保'deploy' => 0（或删掉该键） - 主从模式：
'hostname' => ['192.168.1.10', '192.168.1.11']，且必须同时设'deploy' => 1和'rw_separate' => true - 所有数组字段（
hostname、database、username）长度必须一致，否则master_num切换时会越界 - 敏感配置项（如
password）建议用getenv('DB_PASSWORD')动态注入，避免硬编码进配置文件
动态切换数据库连接后连接数暴涨，Db::connect() 不会自动释放
在中间件里反复调用 Db::setConfig() + Db::connect('key')，ThinkORM 会为每个 key 创建新连接并缓存，但不会自动销毁。Worker 长期运行下，连接池不断膨胀，MySQL 出现大量 SLEEP 状态连接。
- 不要在每次请求中都调用
Db::setConfig()—— 它是全局覆盖操作，且无清理机制 - 正确做法：预加载所有商户配置到内存（如
$merchant_dbs全局变量），用Db::connect($key)显式获取连接实例，用完不关也无妨（ThinkORM 内部有连接复用） - 更稳妥方案：改用
Db::connect($config)传入完整配置数组，避免 key 冲突；该方式不依赖全局 config，也不会污染连接池 - 务必禁用插件自带的定时心跳（
Timer::add(55, ...)），它只对默认连接生效，对动态连接无效，反而增加干扰
PHP 8.4+ 环境下 webman/think-orm 插件直接失效
截至 2026 年 6 月，webman/think-orm v1.1.1 仍未适配 PHP 8.4，其内部反射逻辑在新版本中崩溃，表现为 Db::setConfig() 调用失败，且无明确错误提示。
- 绕过方案：删掉插件自动生成的
config/thinkorm.php和启动器，新建app/init/ThinkOrmInit.php - 该文件实现
WebmanBootstrap接口，在start()中手动读取自定义配置（如config/think_orm.php），再调用Db::setConfig($config) - 将该类加入
config/bootstrap.php的启动列表末尾，确保在 Worker 启动后、业务逻辑前执行 - 此时必须显式添加 MySQL 心跳（
WorkermanTimer::add(55, fn() => Db::connect()->query('select 1'))），插件不再代劳
最易被忽略的一点：ThinkORM 的连接池和断线重连（break_reconnect）只对通过 Db::connect() 获取的连接生效，对直接 new PDO 或手动 new Connection 的实例完全无效——别试图自己封装连接管理，那只会绕开所有内置保护机制。
