Python Requests 接口测试速查版照着抄就能调通接口不讲大道理只给能直接用的东西发请求的骨架、三种传参怎么选、鉴权怎么写、登录态怎么保持、断言怎么写、批量怎么跑、坑怎么躲。所有代码基于 httpbin.org / jsonplaceholder 公开测试接口复制即可运行不需要搭任何后端。文末附完整 8 章系统教程入口。一、最小可用请求先跑通再谈其它importrequests# 三步完成一次接口调用发请求 → 看状态码 → 取数据resprequests.get(https://httpbin.org/get,timeout5)print(resp.status_code)# 200 表示通信成功不代表业务正确print(resp.json())# JSON 响应直接转成 dict写接口测试就是反复做这三步变化的只是方法、参数、断言。取数记住三取四舍取什么写法说明状态码resp.status_code断言的第一道关卡JSON 数据resp.json()有括号响应必须是合法 JSON文本 / 二进制resp.text/resp.content二进制用于下载文件别用 texttimeout必填——不填碰上不响应的服务器脚本直接卡死且不报任何错。两个免费练习服务httpbin.org会把你的请求原样回显验证参数、头、Cookie 发对没有jsonplaceholder.typicode.com提供文章/用户/待办等典型资源只读演示写入请求会假装成功但不会真正落库。二、一个函数打天下工作中的通用骨架defcall(method,path,basehttps://httpbin.org,sessionNone,**kw):统一请求入口超时兜底 异常捕获 会话复用全部请求走这一个口try:return(sessionorrequests).request(method,basepath,timeout5,**kw)exceptrequests.exceptions.RequestExceptionase:print(f[FAIL]{method}{path}:{type(e).__name__}{e})raise之后所有接口call(GET, /get, params{...})、call(POST, /anything, json{...})。超时、异常、日志在一个口子生效换环境只改base这是从脚本迈向框架的第一步。三、传参速查80% 的接口问题出在这里GET 参数 →params字典中文、特殊字符自动编码永远别手拼 URLresprequests.get(https://httpbin.org/get,params{kw:python测试})# 实际发出: /get?kwpython%26%E6%B5%8B%E8%AF%95 —— 自动转 %26中文自动转义POST 三种传参选错后端就收不到。判断依据只有一条看接口文档标注的 Content-Type文档没写就看浏览器 F12 抓包里的 Request Headers场景写法Content-Type现代 JSON 接口主流requests.post(url, json{a: 1})application/json传统表单 / 老接口requests.post(url, data{a: 1})application/x-www-form-urlencoded上传文件requests.post(url, files{f: open(x.txt, rb)}, data{note: 说})multipart/form-data三者区别一句话json保留数据类型数字还是数字data全变字符串files专管二进制文件。文件对象必须用rb模式打开。配套的大文件下载用流式写盘内存占用恒定别一次读进内存rrequests.get(https://httpbin.org/bytes/2048,streamTrue)# 开启流式withopen(f.bin,wb)asf:# wb二进制写模式forchunkinr.iter_content(chunk_size1024):# 每次取 1KB 块f.write(chunk)# 逐块落盘请求头 / Token一个空格都不能错token登录接口返回的 tokenresprequests.get(https://httpbin.org/headers,headers{Authorization:fBearer{token}})# Bearer 与 token 之间必须有且仅有一个空格少了 → 401BasicAuth 一行代码内部老系统常见resprequests.get(https://httpbin.org/basic-auth/user/pwd,auth(user,pwd))# 库自动做 Base64别手拼四、登录态Session 会话保持HTTP 无状态服务器记不住你上次登录过。让 Session 对象充当浏览器记住 Cookiesessrequests.Session()# 一个会话对象 一个浏览器sess.get(https://httpbin.org/cookies/set/sid/abc)# 模拟登录服务器下发 Cookierespsess.get(https://httpbin.org/cookies)# 后续请求仍用 sess 发print(resp.json())# {cookies: {sid: abc}} —— Cookie 被自动带上了核心规则登录和后续请求必须用同一个 Session 对象。中途换成裸requests.get登录态立刻断全链路 401——这是新人最常见的事故现场。五、断言三层打底缺一层都不算测完resprequests.get(https://jsonplaceholder.typicode.com/posts/1)assertresp.status_code200,f状态码异常{resp.status_code}# ① 状态码dataresp.json()asserttitleindata,缺少 title 字段# ② 字段存在assertdata[userId]1,fuserId{data[userId]}# ③ 字段值三条纪律每个 assert 必须带失败提示消息批量跑挂了一排才知道谁挂不能只断状态码通信成功 ≠ 业务正确字符串比较用别用is。列表接口再加两条断len(x)和首元素字段结构。六、鉴权过期兜底 批量循环上线前必读Token 会过期硬编码 token 几小时后全量 401。工程做法是过期自动重登defcall_with_auth():respcall(GET,/headers,headers{Authorization:fBearer{token}})ifresp.status_codein(401,403):# token 疑似失效tokenlogin()# 重新登录换新 tokenreturncall_with_auth()# 用新 token 重试一次returnresp批量循环数据放列表用例写一遍——参数化最小形态forpid,uidin[(1,1),(2,1),(83,10)]:# (文章编号, 预期作者)rrequests.get(fhttps://jsonplaceholder.typicode.com/posts/{pid},timeout5)assertr.status_code200andr.json()[userId]uid,f文章{pid}校验失败要进测试框架时把函数改成test_开头、循环改成pytest.mark.parametrizepytest 就自动收集执行了。写法长这样存成test_demo.py后终端执行pytest -vimportpytest,requestspytest.mark.parametrize(pid,uid,[(1,1),(2,1)],ids[文章1,文章2])deftest_post_owner(pid,uid):# 函数名以 test_ 开头才会被 pytest 收集rrequests.get(fhttps://jsonplaceholder.typicode.com/posts/{pid},timeout5)assertr.status_code200assertr.json()[userId]uid# 两条数据变两条独立用例报告里逐条列出管这叫参数化七、实战节奏从接口文档到一条用例拿到一份接口文档按四步走全流程不超过 20 分钟读四个要素请求方法GET/POST、URL 路径、Content-Type决定用json还是data、必填参数——本文第一到第四节教的东西在这里对应落地先发一次请求打印响应看清结构print(resp.text)见过真实字段再写断言没见过结构就写断言必然翻车落三层断言见第五节正向用例成立补负向用例缺必填参数、参数类型传错、越权访问断言期望的 4xx 状态码。负向用例挡住乱输也成功的接口价值不亚于正向。排障三板斧任何失败五分钟内定位一看状态码分类4xx 查自己的请求5xx 找后端二看响应体错误信息三看resp.request.url和resp.request.headers——比对你以为发的和实际发的请求十有八九差异就在这。八、超时与异常批量任务的生命线try:resprequests.get(url,timeout(3,5))# (连接超时3秒, 读取超时5秒)exceptrequests.exceptions.Timeout:print(超时服务器/网络问题非脚本 bug)exceptrequests.exceptions.RequestExceptionase:print(网络层异常:,type(e).__name__,e)# 父类兜底捕获全部两个要点4xx/5xx不会抛异常是正常返回靠状态码断言判断对错手动重试只用于幂等接口GET/PUT/DELETE下单类 POST 别重试——防止重复订单。九、高频坑速查表踩过才总结得出来的现象原因解决MissingSchemaURL 漏了 http:// 前缀补协议前缀参数发了但服务端收不到data和json用反按文档 Content-Type 选写法登录了还连续 401后续请求没用同一个 Session全程同一个 sess中文参数乱码/被截断手拼 URL 未编码一律走params字典json()解析报错被重定向到登录页响应是 HTML查resp.history与resp.url脚本卡死不报错没设 timeout所有请求带 timeoutSSLError测试环境自签名证书verifyFalse仅限测试环境import requests后诡异报错自己建了requests.py文件立即改名文件不许与库同名断言全绿但没测业务只断状态码按第五节补三层断言响应是空字符串看错了属性 / HEAD、204 方法先打status_code再核对取数属性十、30 秒用例自查清单写完一条用例过一遍① timeout 有没有 ② 状态码断言有没有 ③ 业务数据断言有没有 ④ 网络异常捕获有没有 ⑤ Session 是否全程同一个 ⑥ token 有没有过期兜底。以上是速查版全部内容。若要从零系统掌握HTTP 协议原理、七大请求方法、响应乱码治理、文件上传下载、HTTPS 证书、pytest 参数化实战、完整异常排查手册、requests 二次封装与框架搭建请阅读完整教程《Python Requests库接口测试从零完整指南》8 章完整版所有代码逐行注释、示例全部复制可运行本账号主页可见#Python #接口测试 #requests #自动化测试