// LATEST

配置看起来兼容 Pydantic 两代,为什么仍要逐行核对

配置文件中有 Pydantic 旧版本兼容分支,但项目依赖固定了 Pydantic 2.5.0 与 pydantic-settings 2.1.0。阅读时应先明确实际支持矩阵,而不是把捕获导入异常当作兼容保证。

导入兼容不是调用兼容

旧分支把 validator 重命名为 field_validator,后面的装饰器却仍使用 mode='before'。仅更换名字,不会让两代装饰器自动拥有相同参数。自定义的 SettingsConfigDict 也不等同于完整的旧版配置机制。

因此这段代码最多表达“想兼容”,不能证明旧版本可以运行。既然依赖已经固定为第二代,最简洁的维护策略往往是明确只支持该版本,再删除未经测试的分支;若确需跨代,则分别实现并测试。

DET_SIZE 的类型边界

DET_SIZE 是列表,验证器又尝试接受 '(640, 640)' 这样的字符串。环境变量进入复杂字段时,设置库可能先做 JSON 解码,再到字段验证器。不能仅看到 before 验证器,就认定任何括号字符串都能从环境变量顺利进入它。

建议在固定依赖环境分别验证默认列表、[640,640]、括号形式、空值、非整数和长度错误。当前验证器只负责拆分并转整数,没有明确约束“恰好两个正整数”。这也是配置错误可能延迟到模型初始化才暴露的原因。

配置存在不代表已经生效

WORKERS 默认四个,但 python main.py 路径中 Uvicorn 明确使用 workers=1。配置类的字段并没有自动接管启动参数。Redis 与缓存配置也需要追踪实际调用,不能把声明视为实现。

字段声明 → 环境解析 → 类型校验 → 实际读取 → 运行行为

这五步缺一不可。本文完成的是静态兼容性检查,没有在多个 Pydantic 版本中执行安装测试;涉及解析先后顺序的结论应在锁定环境中复验,而不是写成已经测过的事实。


源码与阅读导航

本文属于「人脸识别服务源码笔记」第 09 篇。依据固定提交 b85ee88017bc 研读,后续版本可能不同。

全部专题与阅读顺序 · 上一篇:线程池不等于无限并发:人脸推理服务的排队边界 · 下一篇:模型只加载一次,是每个进程一次而不是整台机器一次

还没有评论

欢迎留下你的观点,保持交流的清晰和友好。

写下评论