webman中thinkorm配置需手动校验hostname类型：单库用字符串并禁用deploy，主从必须用数组且deploy=1、rw_separate=true；模型须继承support\think\model而非think\model；php8.4需绕过插件手动初始化。
Webman 项目里直接 composer require webman/think-orm 就能开干，但实际跑起来常卡在配置加载、主从报错、模型路径错乱或 PHP 8.4 兼容性上——根本原因不是 ThinkORM 本身有问题，而是插件自动初始化机制和 Webman 启动流程存在隐式耦合。
config/thinkorm.php 配置文件必须手动校验 hostname 类型
ThinkORM 插件自动生成的 config/thinkorm.php 默认把 hostname 写成字符串，但一旦你配主从（'deploy' => 1），就必须改成数组，否则运行时会触发 Array to string conversion 错误，堆栈直指 PDOConnection.php:338。
-
hostname是字符串 → 仅支持单库，deploy和rw_separate必须设为0或删掉 -
hostname是数组（如['192.168.1.10', '192.168.1.11']）→ 必须同时启用'deploy' => 1和'rw_separate' => true，否则连接逻辑不识别从库 - 所有数组字段（
hostname、hostport、database等）长度必须一致，否则master_num切换会越界
模型类命名空间必须用 support\think\Model 而非 think\Model
Webman 的 webman/think-orm 插件做了别名映射，真实加载的是 support\think\Model。如果手写模型时继承了 think\Model，运行时会提示 Class "think\Model" not found，即使 topthink/think-orm 已安装。
- 正确写法：
usesupport\think\Model;+class User extends Model - 错误写法：
usethink\Model;（这是 ThinkPHP 原生用法，Webman 不兼容） -
php webman make:model user tp命令生成的模型默认符合support\think\Model，但前提是没装illuminate/database；若已装，必须加tp参数强制指定
PHP 8.4+ 环境下 webman/think-orm 插件失效需手动接管初始化
截至 2026 年 5 月，webman/think-orm 最新版（v1.1.1）仍未适配 PHP 8.4，调用 Db::setConfig() 时会因内部反射行为变更而崩溃。此时不能删插件，而是绕过它，自己控制初始化时机。
- 新建
app/init/ThinkOrmInit.php，实现Webman\Bootstrap接口 - 在
start()方法里读取自定义配置（比如config/think_orm.php），再调用Db::setConfig($config) - 把该类加到
config/bootstrap.php的启动列表末尾，确保在 Worker 启动后、业务逻辑前执行 - 务必删掉插件自动生成的
config/thinkorm.php和相关定时器代码，避免冲突
Db::table() 查询失败却无报错？检查 trigger_sql 和 break_reconnect
开发中常见「查不到数据也不报错」，表面看是 SQL 问题，实则是连接层静默失败。ThinkORM 默认关闭了 SQL 日志（'trigger_sql' => false），且开启断线重连（'break_reconnect' => true）后，首次查询失败会自动重试一次，掩盖真实异常。
- 调试阶段建议临时开启
'trigger_sql' => true，观察日志里是否出现SQLSTATE[HY000] [2002] Connection refused类错误 - 若数据库空闲超时被服务端断开，仅靠
break_reconnect不够稳定；插件自带的 55 秒心跳只作用于默认连接，多连接需自行补全Timer::add() -
Db::connect('mysql')->query('select 1')手动测试连接是否有效，比盲猜更可靠
最易忽略的一点：ThinkORM 的表前缀（prefix）是拼接在 Db::table('user') 的字符串上的，不是模型里的 $table 属性——后者必须写不含前缀的纯表名，否则会变成 prefix_prefix_user。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
