最有效方式是开启调试模式并捕获弃用警告：设app_debug=true、error_reporting(E_ALL)，在public/index.php加set_error_handler抛出ErrorException；同时避免method_exists()判断魔术方法，改用get_class_methods()过滤。
查清当前版本的废弃函数列表
ThinkPHP 从 5.1 升到 6.x、再到 8.x，vendor/topthink/thinkphp/src/traits/ 和 library/think/ 下大量方法被标记为 @deprecated，但不会自动报错。直接运行旧代码常出现“方法不存在”或静默降级行为，比如 Db::name('user')->where('id', 1)->find() 在 8.x 中仍可用，但底层已走兼容层，性能下降且可能在下个小版本移除。
最有效的方式是打开调试模式后主动触发弃用警告：
- 确保
app_debug = true且错误报告开启（error_reporting(E_ALL)） - 在入口文件
public/index.php顶部加：set_error_handler(function($level, $msg) { if (strpos($msg, 'Deprecated') !== false || strpos($msg, '已废弃') !== false) { throw new ErrorException($msg, $level); } }); - 访问任意会调用旧 API 的页面，PHP 将抛出异常并定位到具体行——比翻文档快得多
对比 vendor 中核心类的 method_exists 行为差异
很多适配问题源于 method_exists() 在不同版本对魔术方法（如 __call）的判断逻辑变化。例如 TP6 默认关闭了对 __call 的反射检查，而 TP5.1 会返回 true；升级后你写的 if (method_exists($obj, 'save')) { ... } 可能突然跳过分支。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 不要依赖
method_exists()判断模型方法是否存在，改用in_array('save', get_class_methods($obj))（TP6+ 更可靠） - 若必须做运行时方法探测，优先查
get_class_methods()+ 过滤掉__开头的魔术方法 - 注意
Db::table()在 TP6.0.12+ 返回Query实例，而 TP5.1 返回Query的子类，instanceof判断可能失效
快速定位 config 文件中被移除的配置项
TP6 起彻底移除了 database.type 这类扁平键，改为 database.connections.mysql.type；TP8 又废弃了 cache.default，强制要求显式指定驱动。不改配置会导致启动即报 InvalidArgumentException: Cache type [file] not support 或静默使用默认驱动。
排查步骤：
- 运行
php think optimize:config（TP6+），它会扫描config/下所有 PHP 文件并提示已废弃键名 - 手动 grep 关键字：
grep -r "database\.type\|cache\.default\|log\.level" config/
- 重点关注
config/app.php中的middleware数组：TP6 要求中间件类必须实现think\MiddlewareInterface，否则加载失败但无明确提示
用 trait 替代继承来绕过类层级断裂
TP5.1 的 think\Model 是基类，很多项目直接继承并重写 initialize()；TP6+ 改为组合式设计，think\Model 只是空壳，实际逻辑在 think\model\Pivot 或 think\model\concern\Attribute 等 trait 中。硬继承会导致 parent::initialize() 找不到或调用顺序错乱。
正确做法：
- 把原
app\model\User extends \think\Model改为app\model\User（不继承），然后use think\model\Pivot, think\model\concern\Attribute; - 原
protected $autoWriteTimestamp = true;需显式调用$this->autoWriteTimestamp();（TP6.3+ 后 trait 不再自动注册） - 若用到了
scope，确认是否还在think\model\concern\SoftDelete里——TP8 已将其拆到独立包topthink/think-soft-delete，需单独安装
版本适配最难的不是功能缺失，而是那些没报错、没日志、只悄悄改了执行路径的地方。尤其注意 trait 方法的加载时机和配置键的嵌套层级，这两处最容易漏测。
