FastAPI 依赖覆盖dependency_overrides测试实战在测试中精准替换任意依赖及其源码原理【免费下载链接】fastapiFastAPI framework, high performance, easy to learn, fast to code, ready for production项目地址: https://gitcode.com/GitHub_Trending/fa/fastapi本篇围绕 FastAPI 官方文档《Testing Dependencies with Overrides》展开讲解如何在测试中通过app.dependency_overrides属性整体替换任意依赖包括其全部子依赖链并深入剖析该机制在fastapi/dependencies/utils.py中的实现原理以及测试用例覆盖的各类生效场景路径操作函数、装饰器参数、include_router引入的依赖、Security依赖等帮助你写出既稳定又快、不依赖外部服务的测试。1. 为什么需要在测试中覆盖依赖在真实的 Web 应用中路径操作函数往往通过Depends()依赖数据库会话、外部认证服务等资源。例如一个典型场景你有一个外部认证提供方external authentication provider需要向其发送 token它返回一个已认证的用户该服务按请求计费且每次调用都比使用固定的 mock 用户多花不少时间你大概只希望对这个外部服务真正测试一次而不希望每一个测试用例都真实调用它。此时你不希望让原始依赖以及它可能携带的整条子依赖链在测试中执行而是想提供一个只在测试中使用的替代依赖返回一个可以被下游代码正常消费的固定值比如 mock 用户。这就是 FastAPI 提供的dependency overrides依赖覆盖机制要解决的问题在测试中用另一个函数“顶替”原始依赖且原始依赖及其子依赖都不会被执行。2. 核心机制app.dependency_overrides属性FastAPI应用实例上有一个属性app.dependency_overrides它是一个普通的dict键key原始依赖函数函数对象本身值value用于替代它的依赖函数另一个函数对象。设置之后FastAPI 在解析依赖时就会调用覆盖函数而不是原始依赖。官方教程示例docs_src/dependency_testing/tutorial001_an_py310.py完整地演示了这一流程核心代码如下from typing import Annotated from fastapi import Depends, FastAPI from fastapi.testclient import TestClient app FastAPI() async def common_parameters(q: str | None None, skip: int 0, limit: int 100): return {q: q, skip: skip, limit: limit} app.get(/items/) async def read_items(commons: Annotated[dict, Depends(common_parameters)]): return {message: Hello Items!, params: commons} app.get(/users/) async def read_users(commons: Annotated[dict, Depends(common_parameters)]): return {message: Hello Users!, params: commons} client TestClient(app) async def override_dependency(q: str | None None): return {q: q, skip: 5, limit: 10} app.dependency_overrides[common_parameters] override_dependency def test_override_in_items(): response client.get(/items/) assert response.status_code 200 assert response.json() { message: Hello Items!, params: {q: None, skip: 5, limit: 10}, } def test_override_in_items_with_q(): response client.get(/items/?qfoo) assert response.status_code 200 assert response.json() { message: Hello Items!, params: {q: foo, skip: 5, limit: 10}, } def test_override_in_items_with_params(): response client.get(/items/?qfooskip100limit200) assert response.status_code 200 assert response.json() { message: Hello Items!, params: {q: foo, skip: 5, limit: 10}, }这段代码中有几个值得注意的行为细节均已被示例中的断言验证覆盖是全局生效的common_parameters同时被/items/和/users/两个路径操作使用设置一次覆盖后所有使用它的路径操作都改走override_dependency。覆盖函数拥有独立的请求参数签名override_dependency只声明了q: str | None None一个参数因此请求中即使携带了skip100limit200这些值也不会传入覆盖函数测试test_override_in_items_with_params中可以看到最终params固定为{q: foo, skip: 5, limit: 10}——参数以覆盖函数的签名为准而不是原始依赖的签名。覆盖函数同样支持 async/sync、查询参数等常规依赖特性它是作为一个“新的依赖”被解析的。2.1 覆盖的适用范围你可以为应用中任意位置使用的依赖设置覆盖路径操作函数path operation function中的Depends()路径操作装饰器的dependencies[Depends(...)]参数即你不使用其返回值、仅用于校验或执行副作用的依赖.include_router()调用时传入的dependencies[Depends(...)]以及其他任何被依赖解析器解析到的位置。FastAPI 仍然能够正确覆盖上述所有位置的依赖——这在仓库自身的测试中得到了验证tests/test_dependency_overrides.py 针对main-depends/主应用路径操作参数、decorator-depends/主应用装饰器、router-depends/路由器路径操作参数、router-decorator-depends/路由器装饰器四种挂载方式分别设置了覆盖并断言参数被替换为{q: None, skip: 5, limit: 10}。2.2 重置覆盖测试结束后或想恢复原始行为时将app.dependency_overrides置为空dict即可移除全部覆盖app.dependency_overrides {}提示如果你只想在某些特定测试中启用覆盖可以在测试函数开头设置覆盖、在测试函数结尾重置。这正是官方测试的写法例如 tests/test_dependency_overrides.py 中的test_override_simpledef test_override_simple(url, status_code, expected): app.dependency_overrides[common_parameters] overrider_dependency_simple response client.get(url) assert response.status_code status_code assert response.json() expected app.dependency_overrides {}这种“测试内设置、测试内清理”的模式保证了覆盖不会泄漏到其它测试用例是编写隔离测试的最佳实践。3. 源码级原理覆盖是如何生效的下面从 FastAPI 源码梳理dependency_overrides的完整调用链帮助理解“为什么覆盖函数签名会决定请求参数”“为什么子依赖链会被整体替换”这两个关键行为。3.1dependency_overrides在应用上的注册在 fastapi/applications.py 中FastAPI.__init__为应用实例初始化了该属性self.dependency_overrides: Annotated[ dict[Callable[..., Any], Callable[..., Any]], Doc( A dictionary with overrides for the dependencies. Each key is the original dependency callable, and the value is the actual dependency that should be called. This is for testing, to replace expensive dependencies with testing versions. ... ), ] {} self.router: routing.APIRouter routing.APIRouter( ... dependency_overrides_providerself, ... )两个要点它就是一个dict键为“原始依赖可调用的函数”值为“实际将被调用的依赖”应用实例自身被作为dependency_overrides_provider传给了主路由器。此后在路由器的传递过程中见 fastapi/routing.py 中route.dependency_overrides_provider dependency_overrides_provider每个APIRoute都会持有对它的引用因此在路由解析阶段就能拿到这个覆盖表。3.2 依赖解析时的替换逻辑真正的替换发生在依赖求解函数 fastapi/dependencies/utils.py 的solve_dependencies()中关键片段for sub_dependant in dependant.dependencies: sub_dependant.call cast(Callable[..., Any], sub_dependant.call) call sub_dependant.call use_sub_dependant sub_dependant if ( dependency_overrides_provider and dependency_overrides_provider.dependency_overrides ): original_call sub_dependant.call call getattr( dependency_overrides_provider, dependency_overrides, {} ).get(original_call, original_call) use_path: str sub_dependant.path # type: ignore use_sub_dependant get_dependant( pathuse_path, callcall, namesub_dependant.name, parent_oauth_scopes_get_oauth_scopes(dependantsub_dependant), scopesub_dependant.scope, ) solved_result await solve_dependencies( requestrequest, dependantuse_sub_dependant, ... )从这段源码结构看可以确认三个行为匹配键是“函数对象”以原始依赖函数对象original_call为键去查dependency_overrides字典.get(original_call, original_call)查不到则保持原样。因此设置覆盖时必须使用与声明Depends()时完全相同的函数对象同一个函数引用别名或重新赋值会导致匹配失败。替换发生在“子依赖”层面循环遍历当前依赖节点的每个sub_dependant命中覆盖时通过get_dependant(callcall, ...)基于覆盖函数重新生成依赖节点。这就是“覆盖函数的签名决定请求参数”的原因——参数、默认值、校验都按覆盖函数的定义重新计算原始依赖的签名不再参与解析。替换是整树替换被覆盖后递归求解使用的是重建的use_sub_dependant因此原始依赖声明的所有子依赖都不会再执行覆盖函数自己声明的子依赖则会照常递归解析同样可以继续被覆盖因为递归中仍传入了dependency_overrides_provider。3.3 一个隐藏细节覆盖会影响依赖缓存键FastAPI 对同一请求内被多次使用的依赖做缓存避免重复执行。缓存键的计算在 fastapi/dependencies/utils.py 的_get_cache_key()中def _get_cache_key(dependant: Dependant, uses_scopes_cache: dict[str, bool] | None None) - DependencyCacheKey: _hash id(dependant.call) scope dependant.scope return (_hash, scope)由于覆盖后dependant.call换成了覆盖函数id(dependant.call)自然不同——被覆盖的依赖不会与原始依赖的缓存结果互相污染缓存机制与覆盖机制天然兼容。4. 进阶场景验证带子依赖的覆盖函数与Security依赖官方文档只展示了最简单的覆盖但仓库测试还验证了更复杂的两类场景值得在实战中了解。4.1 覆盖函数自己可以携带子依赖tests/test_dependency_overrides.py 中定义了一个带子依赖的覆盖函数async def overrider_sub_dependency(k: str): return {k: k} async def overrider_dependency_with_sub(msg: dict Depends(overrider_sub_dependency)): return msg设置app.dependency_overrides[common_parameters] overrider_dependency_with_sub后请求/main-depends/不再需要原始参数q而是要求覆盖链上的新参数k缺失时返回 422见 tests/test_dependency_overrides.py 的test_override_with_sub_main_depends请求/main-depends/?kbar时返回{in: main-depends, params: {k: bar}}见 tests/test_dependency_overrides.py 的test_override_with_sub_main_depends_k_bar。这说明覆盖函数是一个完全独立的依赖它可以有自己的参数、自己的子依赖整个“覆盖依赖树”照常参与校验与求解。4.2Security()依赖同样可被覆盖tests/test_dependency_security_overrides.py 验证了以Security()声明的依赖也可以被dependency_overrides替换且scopes声明仍然生效def test_override_security(): app.dependency_overrides[get_user] get_user_override response client.get(/user) assert response.json() { user: alice, scopes: [foo, bar], data: [1, 2, 3], } app.dependency_overrides {}这对测试“需要外部 OAuth / 认证服务返回用户”的路径操作非常有用生产依赖解析 token、调用外部提供方被替换为直接返回固定用户的 mock而SecurityScopes等机制保持正常。5. 实战要点与注意事项小结综合官方文档与仓库源码/测试使用app.dependency_overrides时注意以下几点要点说明依据键必须是原始依赖函数对象字典匹配依赖函数引用相同.get(original_call, original_call)别名不生效fastapi/dependencies/utils.py覆盖整条依赖链原始依赖及其子依赖都不再执行参数签名以覆盖函数为准fastapi/dependencies/utils.py、docs_src/dependency_testing/tutorial001_an_py310.py覆盖对装饰器/Router 级依赖同样生效主应用、include_router的路径操作与装饰器依赖均可覆盖tests/test_dependency_overrides.pySecurity()依赖可覆盖scopes 声明仍参与解析tests/test_dependency_security_overrides.py用空字典重置app.dependency_overrides {}建议“测试内设置、测试内清理”以避免用例间泄漏官方文档、tests/test_dependency_overrides.py返回值需与原依赖可互换覆盖函数返回的值会被下游路径操作函数按原依赖的用途消费需保证类型/结构兼容示例代码断言6. 小结FastAPI 的依赖覆盖机制以“一个字典”的极简设计解决了测试中最常见的问题——把昂贵、慢速或不稳定的外部依赖认证服务、数据库、第三方 API整体替换为快速、确定的 mockAPI 层面app.dependency_overrides[原依赖函数] 覆盖函数app.dependency_overrides {}重置实现层面FastAPI实例作为dependency_overrides_provider贯穿路由器与路由solve_dependencies()在逐层递归解析时对每个子依赖查表替换并用覆盖函数重建依赖节点从而天然实现“整树替换 独立签名 缓存隔离”验证层面仓库测试覆盖了路径操作参数、装饰器参数、Router 参数、Router 装饰器参数、带子依赖的覆盖函数以及Security()依赖等场景证明该机制在所有常见的依赖挂载方式下均可用。掌握这一机制后你可以把测试与外部世界完全解耦外部服务只集成测试一次其余用例全部走 mock测试既快又可重复。【免费下载链接】fastapiFastAPI framework, high performance, easy to learn, fast to code, ready for production项目地址: https://gitcode.com/GitHub_Trending/fa/fastapi创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/9/7 2:55:35 · 阅读 1.2k FastAPI 依赖覆盖（dependency_overrides）测试实战：在测试中精准替换任意依赖及其源码原理
FastAPI 依赖覆盖dependency_overrides测试实战在测试中精准替换任意依赖及其源码原理【免费下载链接】fastapiFastAPI framework, high performance, easy to learn, fast to code, ready for production项目地址: https://gitcode.com/GitHub_Trending/fa/fastapi本篇围绕 FastAPI 官方文档《Testing Dependencies with Overrides》展开讲解如何在测试中通过app.dependency_overrides属性整体替换任意依赖包括其全部子依赖链并深入剖析该机制在fastapi/dependencies/utils.py中的实现原理以及测试用例覆盖的各类生效场景路径操作函数、装饰器参数、include_router引入的依赖、Security依赖等帮助你写出既稳定又快、不依赖外部服务的测试。1. 为什么需要在测试中覆盖依赖在真实的 Web 应用中路径操作函数往往通过Depends()依赖数据库会话、外部认证服务等资源。例如一个典型场景你有一个外部认证提供方external authentication provider需要向其发送 token它返回一个已认证的用户该服务按请求计费且每次调用都比使用固定的 mock 用户多花不少时间你大概只希望对这个外部服务真正测试一次而不希望每一个测试用例都真实调用它。此时你不希望让原始依赖以及它可能携带的整条子依赖链在测试中执行而是想提供一个只在测试中使用的替代依赖返回一个可以被下游代码正常消费的固定值比如 mock 用户。这就是 FastAPI 提供的dependency overrides依赖覆盖机制要解决的问题在测试中用另一个函数“顶替”原始依赖且原始依赖及其子依赖都不会被执行。2. 核心机制app.dependency_overrides属性FastAPI应用实例上有一个属性app.dependency_overrides它是一个普通的dict键key原始依赖函数函数对象本身值value用于替代它的依赖函数另一个函数对象。设置之后FastAPI 在解析依赖时就会调用覆盖函数而不是原始依赖。官方教程示例docs_src/dependency_testing/tutorial001_an_py310.py完整地演示了这一流程核心代码如下from typing import Annotated from fastapi import Depends, FastAPI from fastapi.testclient import TestClient app FastAPI() async def common_parameters(q: str | None None, skip: int 0, limit: int 100): return {q: q, skip: skip, limit: limit} app.get(/items/) async def read_items(commons: Annotated[dict, Depends(common_parameters)]): return {message: Hello Items!, params: commons} app.get(/users/) async def read_users(commons: Annotated[dict, Depends(common_parameters)]): return {message: Hello Users!, params: commons} client TestClient(app) async def override_dependency(q: str | None None): return {q: q, skip: 5, limit: 10} app.dependency_overrides[common_parameters] override_dependency def test_override_in_items(): response client.get(/items/) assert response.status_code 200 assert response.json() { message: Hello Items!, params: {q: None, skip: 5, limit: 10}, } def test_override_in_items_with_q(): response client.get(/items/?qfoo) assert response.status_code 200 assert response.json() { message: Hello Items!, params: {q: foo, skip: 5, limit: 10}, } def test_override_in_items_with_params(): response client.get(/items/?qfooskip100limit200) assert response.status_code 200 assert response.json() { message: Hello Items!, params: {q: foo, skip: 5, limit: 10}, }这段代码中有几个值得注意的行为细节均已被示例中的断言验证覆盖是全局生效的common_parameters同时被/items/和/users/两个路径操作使用设置一次覆盖后所有使用它的路径操作都改走override_dependency。覆盖函数拥有独立的请求参数签名override_dependency只声明了q: str | None None一个参数因此请求中即使携带了skip100limit200这些值也不会传入覆盖函数测试test_override_in_items_with_params中可以看到最终params固定为{q: foo, skip: 5, limit: 10}——参数以覆盖函数的签名为准而不是原始依赖的签名。覆盖函数同样支持 async/sync、查询参数等常规依赖特性它是作为一个“新的依赖”被解析的。2.1 覆盖的适用范围你可以为应用中任意位置使用的依赖设置覆盖路径操作函数path operation function中的Depends()路径操作装饰器的dependencies[Depends(...)]参数即你不使用其返回值、仅用于校验或执行副作用的依赖.include_router()调用时传入的dependencies[Depends(...)]以及其他任何被依赖解析器解析到的位置。FastAPI 仍然能够正确覆盖上述所有位置的依赖——这在仓库自身的测试中得到了验证tests/test_dependency_overrides.py 针对main-depends/主应用路径操作参数、decorator-depends/主应用装饰器、router-depends/路由器路径操作参数、router-decorator-depends/路由器装饰器四种挂载方式分别设置了覆盖并断言参数被替换为{q: None, skip: 5, limit: 10}。2.2 重置覆盖测试结束后或想恢复原始行为时将app.dependency_overrides置为空dict即可移除全部覆盖app.dependency_overrides {}提示如果你只想在某些特定测试中启用覆盖可以在测试函数开头设置覆盖、在测试函数结尾重置。这正是官方测试的写法例如 tests/test_dependency_overrides.py 中的test_override_simpledef test_override_simple(url, status_code, expected): app.dependency_overrides[common_parameters] overrider_dependency_simple response client.get(url) assert response.status_code status_code assert response.json() expected app.dependency_overrides {}这种“测试内设置、测试内清理”的模式保证了覆盖不会泄漏到其它测试用例是编写隔离测试的最佳实践。3. 源码级原理覆盖是如何生效的下面从 FastAPI 源码梳理dependency_overrides的完整调用链帮助理解“为什么覆盖函数签名会决定请求参数”“为什么子依赖链会被整体替换”这两个关键行为。3.1dependency_overrides在应用上的注册在 fastapi/applications.py 中FastAPI.__init__为应用实例初始化了该属性self.dependency_overrides: Annotated[ dict[Callable[..., Any], Callable[..., Any]], Doc( A dictionary with overrides for the dependencies. Each key is the original dependency callable, and the value is the actual dependency that should be called. This is for testing, to replace expensive dependencies with testing versions. ... ), ] {} self.router: routing.APIRouter routing.APIRouter( ... dependency_overrides_providerself, ... )两个要点它就是一个dict键为“原始依赖可调用的函数”值为“实际将被调用的依赖”应用实例自身被作为dependency_overrides_provider传给了主路由器。此后在路由器的传递过程中见 fastapi/routing.py 中route.dependency_overrides_provider dependency_overrides_provider每个APIRoute都会持有对它的引用因此在路由解析阶段就能拿到这个覆盖表。3.2 依赖解析时的替换逻辑真正的替换发生在依赖求解函数 fastapi/dependencies/utils.py 的solve_dependencies()中关键片段for sub_dependant in dependant.dependencies: sub_dependant.call cast(Callable[..., Any], sub_dependant.call) call sub_dependant.call use_sub_dependant sub_dependant if ( dependency_overrides_provider and dependency_overrides_provider.dependency_overrides ): original_call sub_dependant.call call getattr( dependency_overrides_provider, dependency_overrides, {} ).get(original_call, original_call) use_path: str sub_dependant.path # type: ignore use_sub_dependant get_dependant( pathuse_path, callcall, namesub_dependant.name, parent_oauth_scopes_get_oauth_scopes(dependantsub_dependant), scopesub_dependant.scope, ) solved_result await solve_dependencies( requestrequest, dependantuse_sub_dependant, ... )从这段源码结构看可以确认三个行为匹配键是“函数对象”以原始依赖函数对象original_call为键去查dependency_overrides字典.get(original_call, original_call)查不到则保持原样。因此设置覆盖时必须使用与声明Depends()时完全相同的函数对象同一个函数引用别名或重新赋值会导致匹配失败。替换发生在“子依赖”层面循环遍历当前依赖节点的每个sub_dependant命中覆盖时通过get_dependant(callcall, ...)基于覆盖函数重新生成依赖节点。这就是“覆盖函数的签名决定请求参数”的原因——参数、默认值、校验都按覆盖函数的定义重新计算原始依赖的签名不再参与解析。替换是整树替换被覆盖后递归求解使用的是重建的use_sub_dependant因此原始依赖声明的所有子依赖都不会再执行覆盖函数自己声明的子依赖则会照常递归解析同样可以继续被覆盖因为递归中仍传入了dependency_overrides_provider。3.3 一个隐藏细节覆盖会影响依赖缓存键FastAPI 对同一请求内被多次使用的依赖做缓存避免重复执行。缓存键的计算在 fastapi/dependencies/utils.py 的_get_cache_key()中def _get_cache_key(dependant: Dependant, uses_scopes_cache: dict[str, bool] | None None) - DependencyCacheKey: _hash id(dependant.call) scope dependant.scope return (_hash, scope)由于覆盖后dependant.call换成了覆盖函数id(dependant.call)自然不同——被覆盖的依赖不会与原始依赖的缓存结果互相污染缓存机制与覆盖机制天然兼容。4. 进阶场景验证带子依赖的覆盖函数与Security依赖官方文档只展示了最简单的覆盖但仓库测试还验证了更复杂的两类场景值得在实战中了解。4.1 覆盖函数自己可以携带子依赖tests/test_dependency_overrides.py 中定义了一个带子依赖的覆盖函数async def overrider_sub_dependency(k: str): return {k: k} async def overrider_dependency_with_sub(msg: dict Depends(overrider_sub_dependency)): return msg设置app.dependency_overrides[common_parameters] overrider_dependency_with_sub后请求/main-depends/不再需要原始参数q而是要求覆盖链上的新参数k缺失时返回 422见 tests/test_dependency_overrides.py 的test_override_with_sub_main_depends请求/main-depends/?kbar时返回{in: main-depends, params: {k: bar}}见 tests/test_dependency_overrides.py 的test_override_with_sub_main_depends_k_bar。这说明覆盖函数是一个完全独立的依赖它可以有自己的参数、自己的子依赖整个“覆盖依赖树”照常参与校验与求解。4.2Security()依赖同样可被覆盖tests/test_dependency_security_overrides.py 验证了以Security()声明的依赖也可以被dependency_overrides替换且scopes声明仍然生效def test_override_security(): app.dependency_overrides[get_user] get_user_override response client.get(/user) assert response.json() { user: alice, scopes: [foo, bar], data: [1, 2, 3], } app.dependency_overrides {}这对测试“需要外部 OAuth / 认证服务返回用户”的路径操作非常有用生产依赖解析 token、调用外部提供方被替换为直接返回固定用户的 mock而SecurityScopes等机制保持正常。5. 实战要点与注意事项小结综合官方文档与仓库源码/测试使用app.dependency_overrides时注意以下几点要点说明依据键必须是原始依赖函数对象字典匹配依赖函数引用相同.get(original_call, original_call)别名不生效fastapi/dependencies/utils.py覆盖整条依赖链原始依赖及其子依赖都不再执行参数签名以覆盖函数为准fastapi/dependencies/utils.py、docs_src/dependency_testing/tutorial001_an_py310.py覆盖对装饰器/Router 级依赖同样生效主应用、include_router的路径操作与装饰器依赖均可覆盖tests/test_dependency_overrides.pySecurity()依赖可覆盖scopes 声明仍参与解析tests/test_dependency_security_overrides.py用空字典重置app.dependency_overrides {}建议“测试内设置、测试内清理”以避免用例间泄漏官方文档、tests/test_dependency_overrides.py返回值需与原依赖可互换覆盖函数返回的值会被下游路径操作函数按原依赖的用途消费需保证类型/结构兼容示例代码断言6. 小结FastAPI 的依赖覆盖机制以“一个字典”的极简设计解决了测试中最常见的问题——把昂贵、慢速或不稳定的外部依赖认证服务、数据库、第三方 API整体替换为快速、确定的 mockAPI 层面app.dependency_overrides[原依赖函数] 覆盖函数app.dependency_overrides {}重置实现层面FastAPI实例作为dependency_overrides_provider贯穿路由器与路由solve_dependencies()在逐层递归解析时对每个子依赖查表替换并用覆盖函数重建依赖节点从而天然实现“整树替换 独立签名 缓存隔离”验证层面仓库测试覆盖了路径操作参数、装饰器参数、Router 参数、Router 装饰器参数、带子依赖的覆盖函数以及Security()依赖等场景证明该机制在所有常见的依赖挂载方式下均可用。掌握这一机制后你可以把测试与外部世界完全解耦外部服务只集成测试一次其余用例全部走 mock测试既快又可重复。【免费下载链接】fastapiFastAPI framework, high performance, easy to learn, fast to code, ready for production项目地址: https://gitcode.com/GitHub_Trending/fa/fastapi创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考