一、依赖注入Depends让依赖不再写死为什么需要依赖注入之前项目里analyze_jd()这类能力和配置是绑死的谁要用谁就from app.core.config import settings自己读一遍.env甚至函数内部直接import写死配置。问题有三重复浪费每个路由都自己读配置、自己初始化代码抄好几遍。耦合函数把读配置和做业务搅在一起一处出错全链路连坐。没法测配置写死在模块里想换成假配置只能 mock 整个模块很脏。FastAPI 的Depends把这件事翻转过来——依赖不再自己import而是别人喂进来外部注入。怎么用写一个普通函数返回依赖对象路由参数声明Depends(...)请求进来时 FastAPI 自动调用该函数并把返回值塞进参数# app/api/dependencies.pyfromapp.core.configimportSettings,settingsdefget_settings()-Settings:returnsettingsdefget_llm_service()-LlmService:returnLlmService(settings)# app/main.py 的 /healthfromapp.api.dependenciesimportget_settingsfromapp.core.configimportSettingsdefhealth(settings:SettingsDepends(get_settings)):returnHealthResponse(app_namesettings.APP_NAME,...)关键注意点settings的类型注解需要写Settings类大写而实际传入的值由Depends(get_settings)注入因此main.py里只需from app.core.config import Settings不必再import settings实例——类型与实例来源是两回事不要混为一谈。二、中间件Middleware给所有请求统一插一脚为什么需要中间件想记录每个请求花了多久如果在每个路由里手写time.time()重复代码一堆漏写一个就缺数据。中间件是 FastAPI 给的请求前后自动执行一段代码的机制——它包在所有路由外面每个请求都经过。怎么写# app/api/middleware.pyimportloggingimporttime loggerlogging.getLogger(__name__)asyncdeflog_request_time(request,call_next):starttime.time()responseawaitcall_next(request)# 真正执行路由duration_ms(time.time()-start)*1000logger.info(f{request.method}{request.url.path}took{duration_ms:.2f}ms)returnresponse# app/main.py在 app FastAPI() 之后注册fromapp.api.middlewareimportlog_request_time app.middleware(http)(log_request_time)执行顺序请求进 → 记开始时间 → call_next 跑路由 → 拿到 response → 算耗时打日志 → 返回。关键注意点注意日志不打印的问题代码明明执行了终端却看不到耗时日志。根因是 Pythonlogging默认级别是WARNING而中间件用logger.info(...)INFO级别低于WARNING会被直接吞掉更隐蔽的是logging.basicConfig(...)会被uvicorn 启动时覆盖root logger 级别被抬回WARNING。修复方式是显式设置 root logger 并兜底添加 handlerimportlogging root_loggerlogging.getLogger()root_logger.setLevel(logging.INFO)ifnotroot_logger.handlers:handlerlogging.StreamHandler()handler.setFormatter(logging.Formatter(%(asctime)s - %(name)s - %(levelname)s - %(message)s))root_logger.addHandler(handler)三、从函数到类LLM 服务化LlmService为什么改成类之前的call_llm()是模块级函数client OpenAI(...)在模块被 import 的那一刻就执行了——只要.env里 key 少一行任何 import 它的路由一加载就崩/health都起不来。改成LlmService类带来三层好处操作与数据绑定settings存成self.settings方法随用随取不用每次拎参数。可测试__init__(settings)外部传入测试时LlmService(fake_settings)一行搞定呼应前面的Depends注入思想。延迟创建client挪进__init__只有真实例化时才建连接模块能正常 import不再连坐崩溃。改造后的骨架classLlmService:def__init__(self,settings:Settings):self.settingssettings self.clientOpenAI(api_keysettings.DEEPSEEK_API_KEY,base_urlsettings.DEEPSEEK_BASE_URL,)defcall_llm(self,prompt:str,system_prompt:str,temperature:float|NoneNone)-str:iftemperatureisNone:temperatureself.settings.LLM_TEMPERATURE# ... 用 self.client / self.settings.LLM_MODEL / MAX_TOKENS / TIMEOUT ...returncontentdefanalyze_jd(self,jd_text:str)-JdAnalysisResult:user_promptbuild_jd_user_prompt(jd_text)rawself.call_llm(promptuser_prompt,system_promptSYSTEM_PROMPT_JD,temperature0)returnparse_jd_analysis(raw)同时给config.py补了LLM_TEMPERATURE/LLM_MAX_TOKENS/LLM_TIMEOUT三个字段让调用参数全部来自配置而非硬编码。路由层接入新接口/api/v1/jd/analyze-basic-llm只干三件事收请求 → 注入的llm_service.analyze_jd()→ 返回JdAnalysisResult。llm_service不是import死的而是Depends(get_llm_service)注入的router.post(/analyze-basic-llm,response_modelJdAnalysisResult)defanalyze_basic_llm(req:JdAnalyzeRequest,llm_service:LlmServiceDepends(get_llm_service),):returnllm_service.analyze_jd(req.jd_text)四、pytest dependency_overrides用测试证明注入有用为什么写这个测试依赖注入的可替换好处不能只靠嘴说要测试证明。FastAPI 给了一把钥匙app.dependency_overrides。fromfastapi.testclientimportTestClientfromapp.api.dependenciesimportget_settingsfromapp.core.configimportSettingsfromapp.mainimportappdeffake_get_settings():returnSettings(APP_NAMETest App,DEBUGTrue)deftest_health_with_fake_settings():app.dependency_overrides[get_settings]fake_get_settingstry:clientTestClient(app)responseclient.get(/health)assertresponse.status_code200dataresponse.json()assertdata[app_name]Test Appassertdata[debug]isTruefinally:app.dependency_overrides.clear()# 必须清理否则污染其他测试断言app_name Test App通过证明没动.env也换成了假配置。TestClient(app)要在dependency_overrides设置之后创建否则覆盖不生效。技术总结把散落的配置与能力收拢成可注入、可覆盖的依赖用中间件统一处理横切逻辑用类把 LLM 客户端封装成延迟初始化、可测试的服务——这四个实践彼此呼应共同解决的是同一个工程命题让代码从能跑走向可控、可测、可维护。依赖注入是地基中间件是横切面的统一入口服务化封装消除了启动期脆弱性而覆盖测试则为前三者提供了可信保障。
企业数字化 ERP 产品动态
相关推荐
Docker部署Prometheus监控Nginx,并通过Grafana展示监控数据 文章目录总体流程1.Prometheus监控收集Nginx数据2.Grafana展示一.Prometheus监控收集Nginx数据第一步:让 Nginx 暴露内置指标第二步:启动 Nginx Prometheus Exporter第三步:配置 Prometheus 抓取指标并启动二.Grafana展示监控数据第一步&… · 2026/10/22 14:06:34
SwinTransformer解析:窗口机制与视觉任务优化 1. 从视觉任务中的Transformer困境说起 第一次接触SwinTransformer是在2021年的一个图像分割项目里。当时团队正为如何平衡计算效率和模型性能发愁——传统的CNN backbone在密集预测任务中显存占用惊人,而初代Vision Transformer(ViT)虽然效果… · 2026/10/29 10:17:54
Python爬虫实战:逆向破解接口时间戳加密参数 1. 项目概述:当爬虫遇到加密的时间戳 最近在做一个数据采集项目时,遇到了一个典型的“拦路虎”:目标网站的接口参数里,有一个看似普通的 timestamp 字段,但直接使用当前时间戳请求,返回的永远是“签名错误… · 2026/10/23 4:40:05
低压电工证属于多少级多少钱才够用?实操考试心里没底怕挂科 低压电工证属于多少级多少钱才够用?实操考试心里没底怕挂科 实操考试心里没底怕挂科,你不是一个人。很多人在准备低压电工证考试时,最怕的就是动手操作那一关,一不小心就挂科,浪费钱又浪费时间。而且, 多少钱… · 2026/11/22 21:20:41
宁波鄞州哪里考电工证通过率揭秘:外省证书如何转过来 宁波鄞州哪里考电工证通过率揭秘:外省证书如何转过来 之前考的证在外省能不能转过来?这几乎是每个打算在宁波鄞州考电工证的人最关心的问题,尤其是像我这样的许昌转岗从业者,之前在河南工作时考的低压电工证,现在想在宁波继续干电工,就怕证件不能跨省通… · 2026/11/22 21:20:41
低压电工证选择判断怎么过?官方报名入口+学历门槛全解析 低压电工证选择判断怎么过?官方报名入口+学历门槛全解析 你是不是也担心学历不高报不了低压电工证?别急,今天咱们就来说清楚, 低压电工证选择判断 到底怎么过,怎么报名, 官方报名入口 在哪,以及你真的需要哪些条件。… · 2026/11/22 21:20:41
连江电工证培训机构官方回应:实操考试心里没底怕挂科怎么办 连江电工证培训机构官方回应:实操考试心里没底怕挂科怎么办 你有没有遇到过这种情况:电工证实操考试前一天,手心冒汗,脑子里全是“要是考不好怎么办”?我认识的一个信阳浉河区的哥们,去年刚转行做电工,就因为对考试流程不熟悉,差点被实操考试整崩溃了… · 2026/11/22 21:20:41
特种作业防爆操作证吗网上查询跨省转证攻略来了 特种作业防爆操作证吗网上查询跨省转证攻略来了 之前考的证在外省能不能转过来?这个问题我见过太多人问了,尤其是像你在三门峡准备考防爆操作证的朋友,外省证怎么转过来,网上查询流程又复杂又不清楚。今天就拿一个真实案例来带大家理清楚流程,避免你走弯… · 2026/11/22 21:20:41
益阳电工证快速拿证考前押题全攻略,外省证怎么转?南阳工人经验分享 益阳电工证快速拿证考前押题全攻略,外省证怎么转?南阳工人经验分享 之前考的证在外省能不能转过来?这个问题几乎每个准备考电工证的工人都问过。尤其像我们在南阳卧龙区的建筑工人,常年在外奔波,证书在手里,却因为地区限制,用不了,也换不了。但好消息… · 2026/11/22 21:19:41
平价的电工证查询保姆级教程:别被中介坑,一步步教你搞定 平价的电工证查询保姆级教程:别被中介坑,一步步教你搞定 你是不是也经常在网上看到“平价的电工证查询”这样的关键词,但又不知道去哪报名,怕被中介坑?特别是像你这样的平顶山学员,既想考个正规电工证,又怕花冤枉钱走弯路。别担心,这篇保姆级教程就是… · 2026/11/22 0:00:42
麻阳考电工证在哪里考内部消息你知道吗 麻阳考电工证在哪里考内部消息你知道吗 不知道去哪报名怕被中介坑, 内部消息 告诉你,麻阳考电工证不一定要去外地,本地其实也有正规渠道,但很多人因为不了解流程和资质,反而被坑了钱还考不到证。今天我就从一个干了这么多年特种作业培训的“老江湖”角… · 2026/11/22 0:00:43
揭阳普宁电工证换证怎么操作?良心建议帮你理清流程 揭阳普宁电工证换证怎么操作?良心建议帮你理清流程 之前考的证在外省能不能转过来?这是很多已经在外地工作、现在想回揭阳普宁发展的电工朋友最关心的问题。如果你也是其中之一,那这篇文章就是为你们量身定制的,从换证流程到避坑建议,良心建议全给你讲透… · 2026/11/22 0:00:43
平价的电工证查询保姆级教程:别被中介坑,一步步教你搞定 平价的电工证查询保姆级教程:别被中介坑,一步步教你搞定 你是不是也经常在网上看到“平价的电工证查询”这样的关键词,但又不知道去哪报名,怕被中介坑?特别是像你这样的平顶山学员,既想考个正规电工证,又怕花冤枉钱走弯路。别担心,这篇保姆级教程就是… · 2026/11/22 0:00:42
麻阳考电工证在哪里考内部消息你知道吗 麻阳考电工证在哪里考内部消息你知道吗 不知道去哪报名怕被中介坑, 内部消息 告诉你,麻阳考电工证不一定要去外地,本地其实也有正规渠道,但很多人因为不了解流程和资质,反而被坑了钱还考不到证。今天我就从一个干了这么多年特种作业培训的“老江湖”角… · 2026/11/22 0:00:43
揭阳普宁电工证换证怎么操作?良心建议帮你理清流程 揭阳普宁电工证换证怎么操作?良心建议帮你理清流程 之前考的证在外省能不能转过来?这是很多已经在外地工作、现在想回揭阳普宁发展的电工朋友最关心的问题。如果你也是其中之一,那这篇文章就是为你们量身定制的,从换证流程到避坑建议,良心建议全给你讲透… · 2026/11/22 0:00:43
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/22 20:41:13
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/21 15:19:30
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/21 15:19:32