python构建ai推理服务的核心是分层解耦、资源可控、接口清晰;需封装模型逻辑、用fastapi+Uvicorn部署、隔离GPU/CPU资源、集成日志/指标/告警。

用Python构建稳定可扩展的AI模型推理服务系统,核心不在于“堆框架”,而在于分层解耦、资源可控、接口清晰。重点是让模型跑得稳、并发扛得住、升级不中断、问题看得见。
模型封装:别让业务代码直接碰模型
把模型加载、预处理、推理、后处理封装成独立类或模块,与API逻辑彻底分离。例如用torch.nn.Module或transformers.Pipeline加载后,只暴露predict(input)方法;输入输出统一为dict或Pydantic模型,避免类型混乱。支持热重载——模型文件更新时,通过信号或watchdog触发重新加载,无需重启服务。
服务层:用FastAPI + Uvicorn打底,别碰flask默认线程池
FastAPI自带异步支持和自动文档,配合Uvicorn部署能轻松支撑千级QPS。关键配置要改:–workers 4(按CPU核数设)、–limit-concurrency 100防雪崩、–timeout-keep-alive 5减少连接堆积。接口里不做耗时操作,所有模型调用走run_in_executor或提前转为async wrapper,避免阻塞事件循环。
资源隔离:每个模型实例独占GPU显存,别共用一个torch.device(‘cuda’)
多模型混部时,用CUDA_VISIBLE_DEVICES环境变量或torch.cuda.set_device()绑定到指定卡;单卡多实例则用torch.cuda.memory_reserved()做显存预留,防止OOM。CPU模型也建议限制线程数:os.environ[‘OMP_NUM_THREADS’] = ‘2’,避免争抢。
立即学习“Python免费学习笔记(深入)”;
可观测性:加三样东西——请求日志、延迟直方图、错误率告警
- 用structlog记录每次请求ID、输入摘要、耗时、状态码、异常trace
- 用prometheus Client暴露inference_latency_seconds_bucket等指标,grafana看P99延迟趋势
- 错误率超5%自动发钉钉/企业微信,不是等用户投诉才发现
基本上就这些。不复杂但容易忽略——稳定性来自约束,扩展性来自解耦,而可维护性,藏在每次commit的README里。