企业官网建设流程全解析

Python 异步迁移：先替换一段可回退的调用链

把同步服务改成异步，最危险的操作是先把函数签名全改成async，再开始找哪里卡住。网络 I/O、数据库驱动、文件读写和 CPU 计算的处理方式并不一样，外表都叫“阻塞”，脾气可差得很远。

先选一段窄而清楚的链路

从读多写少、输入输出稳定的接口开始。记录原有的超时、重试和错误码，让新旧实现处理同一批请求样本。迁移期保留路由开关，问题出现时能立即回到原逻辑。

别把阻塞函数塞进事件循环

支持异步的客户端直接await；同步 SDK 或 CPU 密集处理则放到受控线程池、进程池或独立 worker。线程池不是垃圾桶，提交前先设并发限制和排队上限。否则看起来异步了，实际上只是把堵车挪到了另一个路口。

取消、连接断开和超时要沿调用链传递。用正常请求、依赖变慢和重复请求验证新路径，保存依赖版本和配置。异步迁移不是换个关键字，是把等待的去向说清楚。