如何在Python Django中通过Mock模块对外部API调用进行单元测试?

夜杰姑娘_2152

夜杰姑娘_2152

2026-07-23

928人浏览

原创

直接调用真实API会导致测试随机失败、变慢且无法覆盖边界情况;Mock通过patch替换requests调用,需按被测代码实际导入路径(如'myapp.views.requests')打桩,并构造含status_code和json方法的Mock响应对象。

如何在python django中通过mock模块对外部api调用进行单元测试?

为什么直接调用真实API会导致测试失败或变慢

单元测试里跑真实网络请求,会暴露三个致命问题:一是网络不稳定让测试随机失败;二是外部API响应时间波动拖慢整个测试套件;三是你无法控制返回数据,比如想测“用户不存在”这种边界情况时,真实服务可能根本不返回这种状态。Mock 的作用就是把 requests.get、requests.post 这类调用替换成可控的返回值,让测试只聚焦逻辑本身。

用 patch 替换目标模块中的函数,而不是导入位置

常见错误是 patch 写成 @patch('requests.get'),这其实没效果——Django 视图或服务里调用的是自己模块内导入的 requests,不是全局 requests 模块。必须按“被测试代码实际导入的位置”来 patch。比如你的视图在 myapp/views.py 里写了 import requests,那就要 patch 'myapp.views.requests';如果写的是 from requests import get,就得 patch 'myapp.views.get'。

  • 查清楚被测函数里怎么引用 requests:打开对应 Python 文件,看 import 语句和调用方式
  • patch 路径格式为 'package.module.function_name',不是 'requests.get'
  • 使用 side_effect 可模拟不同 HTTP 状态码,比如 side_effect=[ConnectionError, Mock(status_code=200)]

构造符合实际结构的 Mock 响应对象

Django 视图通常依赖 response.json() 或 response.status_code,所以不能只 mock 返回字典,得 mock 一个带这些属性的对象。最稳妥的方式是用 Mock 构造一个类实例,手动设置 json 方法和 status_code 属性。

Django Wrap
Django Wrap

强戈环形山: q15040409-刻画家功能概述强戈环形山: q15040409-刻画家是一项面向实际任务的技能,主要用于平顶山: 维西翁: 1:1.0. 塔格斯: rap.github: 自动化。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。核心要点使用时应结合输入条件选择合适的执行方式,核对必要参数、依赖环境与输出内容,并按原始要求处理异常情况。该技能适合需要稳定复用相关能力的场景,可作为自动化工作流的一部分,也便于后续检查、调整和扩展。从功能定位来看,该

下载
from unittest.mock import Mock
<p>mock_response = Mock()
mock_response.status_code = 200
mock_response.json.return_value = {"id": 123, "name": "test"}</p><p>@patch('myapp.services.requests.get', return_value=mock_response)
def test_api_success(self, mock_get):</p><h1>……</h1>
  • 别用 return_value={"data": ...},因为 dict 没有 .json() 方法
  • 如果 API 返回非 JSON(比如 XML 或纯文本),要 mock text 属性而非 json
  • 注意 json.return_value 是方法调用,不是属性赋值,要用 .return_value

测试异常路径时,patch 要覆盖所有可能出错点

真实调用中,requests 可能在连接阶段就抛 ConnectionError,也可能收到 4xx/5xx 状态但没 raise 异常(取决于是否调用 response.raise_for_status())。测试时得分别 mock 这两类行为。

  • 模拟连接失败:用 side_effect=ConnectionError 或 Timeout
  • 模拟 404 响应但不抛异常:设置 status_code=404,并确保被测代码没调 raise_for_status()
  • 模拟 500 并触发异常:设 status_code=500 + side_effect=lambda: mock_response.raise_for_status()

真实项目里,很多同学只测了 success case,漏掉对 except requests.RequestException: 分支的覆盖,结果上线后一连不上就崩。

大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

2023.07.20

1831

4

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

2023.07.25

4944

7

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.31

1789

3

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

2023.08.03

29717

23

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

3547

5

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

3547

5

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

1223

5

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.10

616

4

python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2763

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Uvicorn官方安装与入门手册
Uvicorn官方安装与入门手册

共0课时 | 0人学习

Python uv官方项目管理指南
Python uv官方项目管理指南

共0课时 | 0人学习

Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习