Webman无内置migrate命令，需集成Phinx并正确配置：工作目录须为项目根目录，Phinx默认只读phinx.yml而非phinx.php，Webman的database.php字段名（username/password）与Phinx要求（user/pass）不匹配，插件命令需显式注册，Docker中host须填容器名，迁移文件命名与时序、up/down成对、strict mode兼容性及蓝绿发布单点执行等均影响迁移可靠性。
Webman 没有内置 migrate 命令，所谓“优雅迁移”取决于你能否让 Phinx 真正复用 Webman 的配置、适配部署流程、并在多实例场景下不翻车。
为什么直接运行 vendor/bin/phinx 总报 No config file found
根本原因不是 Phinx 装错了，而是它默认只在当前工作目录找 phinx.yml，而 Webman 项目里通常没这个文件，或者你放的是 phinx.php 却没告诉 Phinx 去读它。
- 确保你在项目根目录（即
start.php所在层）执行命令，不是app/或config/目录下 - Phinx 不会自动加载 Webman 的
config/database.php，字段名也不匹配：Webman 用username/password，Phinx 要user/pass - 若你坚持用
phinx.php，必须显式指定路径：vendor/bin/phinx -c phinx.php migrate，否则它根本不会看这个文件 - Docker 环境下
host必须填容器名（如mysql），写localhost会导致连接拒绝，且错误信息常被吞掉，只显示超时
用 x2nx/webman-migrate 插件却找不到 php webman migrate 命令
插件只是封装了 Phinx，但 Webman 的 console 系统不会自动发现命令——它需要被显式注册。
Webman 2.2.0
下载
Webman 2.2.0版本强化了 TCP/UDP 服务支持，优化路由组管理，并增强异步任务处理能力。结合协程与连接池技术，Webman 能轻松应对高并发场景，适用于网站、接口服务、即时通讯、物联网及游戏开发，兼具高性能、灵活扩展与稳定可靠，是多场景 PHP 服务开发的理想选择。
- 检查
config/plugin/x2nx/webman-migrate/app.php中'enable' => true是否存在且为布尔值true（不是字符串"true"） - 确认
config/plugin/x2nx/webman-migrate/command.php文件存在，且内容调用了Commands::add()注册命令 - 插件默认只认
phinx.yml，如果你用的是phinx.php，得在插件配置里加'config' => 'phinx.php'字段 - 执行
php webman list，如果看不到migrate:开头的命令，说明注册失败，此时php webman migrate必然报错 “Command not found”
迁移文件写完一跑就出错，常见硬伤在哪
Phinx 对迁移文件结构敏感，尤其在 MySQL strict mode 下，微小偏差就会导致建表失败或字段丢失。
- 命名必须是
YYYYMMDDHHIISS_describe_action_table.php格式（如20260615010000_add_email_to_users.php），时间戳错一位，执行顺序就乱 -
up()和down()必须成对，且不能依赖任何业务类（比如User::class或Db::table()），迁移只管结构，不碰数据逻辑 - 新增非空字段带默认值时，MySQL 5.7+ 要显式写
->setDefault('')->nullable(false)，否则 strict mode 下直接报错 - 一旦合并到主干，禁止修改已有迁移文件内容；修复只能靠新增一个
20260615010001_fix_email_column.php来覆盖
上线时自动迁移，为什么蓝绿发布总出问题
因为 php webman migrate 是单机命令，它不感知集群中其他实例是否已执行，也不锁表、不校验状态，多个实例并发跑 migrate 可能写坏 phinxlog 表或重复建索引。
- CI/CD 流程里，迁移必须放在部署流水线的“单点执行阶段”，比如只在 deploy-server 上跑，而不是每台应用服务器都执行
- 生产环境禁用
php webman migrate直接调用，改用明确环境参数：php webman migrate --environment=production，避免误用开发配置 - 回滚操作（
rollback）不可逆，且只退最新一次；若要退到某版本，得用migrate --target=20260614000000，但前提是目标版本之前所有迁移都成功执行过 - 最易被忽略的一点：Phinx 的
phinxlog表默认建在information_schema？错，它建在你配置的name数据库里，如果该库权限不足或磁盘满，迁移会静默失败
