1. 什么是接口測試

顧名思義，接口測試是對系統或組件之間的接口進行測試，主要是校驗數據的交換，傳遞和控制管理過程，以及相互邏輯依賴關系。其中接口協議分為HTTP,WebService,Dubbo,Thrift,Socket等類型，測試類型又主要分為功能測試，性能測試，穩定性測試，安全性測試等。

在分層測試的“金字塔”模型中，接口測試屬于第二層服務集成測試范疇。相比UI層（主要是WEB或APP）自動化測試而言，接口自動化測試收益更大，且容易實現，維護成本低，有著更高的投入產出比，是每個公司開展自動化測試的首選。

下面我們以一個HTTP接口為例，完整的介紹接口自動化測試流程：從需求分析到用例設計，從腳本編寫、測試執行到結果分析，并提供完整的用例設計及測試腳本。

2. 基本流程

基本的接口功能自動化測試流程如下：

需求分析 -> 用例設計 -> 腳本開發 -> 測試執行 -> 結果分析

2.1 示例接口

接口名稱：豆瓣電影搜索

接口文檔地址：https://developers.douban.com/wiki/?title=movie_v2#search

接口調用示例：

1) 按演職人員搜索：https://api.douban.com/v2/movie/search?q=張藝謀

2) 按片名搜索：https://api.douban.com/v2/movie/search?q=大話西游

3) 按類型搜索：https://api.douban.com/v2/movie/search?tag=喜劇

3. 需求分析

需求分析是參考需求、設計等文檔，在了解需求的基礎上還需清楚內部的實現邏輯，并且可以在這一階段提出需求、設計存在的不合理或遺漏之處。

如：豆瓣電影搜索接口，我理解的需求即是支持對片名，演職人員及標簽的搜索，并分頁返回搜索結果。

4. 用例設計

用例設計是在理解接口測試需求的基礎上，使用MindManager或XMind等思維導圖軟件編寫測試用例設計，主要內容包括參數校驗，功能校驗、業務場景校驗、安全性及性能校驗等，常用的用例設計方法有等價類劃分法，邊界值分析法，場景分析法，因果圖，正交表等。

針對豆瓣電影搜索接口功能測試部分，我們主要從參數校驗，功能校驗，業務場景校驗三方面，設計測試用例如下：

5. 腳本開發

依據上面編寫的測試用例設計，我們使用python+nosetests框架編寫了相關自動化測試腳本。可以完整實現接口自動化測試、自動執行及郵件發送測試報告功能。

5.1 相關lib安裝

必要的lib庫如下，使用pip命令安裝即可：

1. pip install nose

2. pip install nose-html-reporting

3. pip install requests

5.2 接口調用

使用requests庫，我們可以很方便的編寫上述接口調用方法（如搜索q=劉德華，示例代碼如下）：

#coding=utf-8import requestsimport jsonurl = 'https://api.douban.com/v2/movie/search'params=dict(q=u'劉德華')r = requests.get(url, params=params)print 'Search Params:\n', json.dumps(params, ensure_ascii=False)print 'Search Response:\n', json.dumps(r.json(), ensure_ascii=False, indent=4)

在實際編寫自動化測試腳本時，我們需要進行一些封裝。如下代碼中我們對豆瓣電影搜索接口進行了封裝，test_q方法只需使用nosetests提供的yield方法即可很方便的循環執行列表qs中每一個測試集：

class test_doubanSearch(object):@staticmethoddef search(params, expectNum=None):url = 'https://api.douban.com/v2/movie/search'r = requests.get(url, params=params)print 'Search Params:\n', json.dumps(params, ensure_ascii=False)print 'Search Response:\n', json.dumps(r.json(), ensure_ascii=False, indent=4)def test_q(self):# 校驗搜索條件 qqs = [u'白夜追兇', u'大話西游', u'周星馳', u'張藝謀', u'周星馳,吳孟達', u'張藝謀,鞏俐', u'周星馳,大話西游', u'白夜追兇,潘粵明']for q in qs:params = dict(q=q)f = partial(test_doubanSearch.search, params)f.description = json.dumps(params, ensure_ascii=False).encode('utf-8')yield (f,)

我們按照測試用例設計，依次編寫每個功能的自動化測試腳本即可。

5.3 結果校驗

在手工測試接口的時候，我們需要通過接口返回的結果判斷本次測試是否通過，自動化測試也是如此。

對于本次的接口，我們搜索“q=劉德華”，我們需要判斷返回的結果中是否含有“演職人員劉德華或片名劉德華”，搜索“tag=喜劇”時，需要判斷返回的結果中電影類型是否為“喜劇”，結果分頁時需要校驗返回的結果數是否正確等。完整結果校驗代碼如下：

class check_response():@staticmethoddef check_result(response, params, expectNum=None):# 由于搜索結果存在模糊匹配的情況，這里簡單處理只校驗第一個返回結果的正確性if expectNum is not None:# 期望結果數目不為None時，只判斷返回結果數目eq_(expectNum, len(response['subjects']), '{0}!={1}'.format(expectNum, len(response['subjects'])))else:if not response['subjects']:# 結果為空，直接返回失敗assert Falseelse:# 結果不為空，校驗第一個結果subject = response['subjects'][0]# 先校驗搜索條件tagif params.get('tag'):for word in params['tag'].split(','):genres = subject['genres']ok_(word in genres, 'Check {0} failed!'.format(word.encode('utf-8')))# 再校驗搜索條件qelif params.get('q'):# 依次判斷片名，導演或演員中是否含有搜索詞，任意一個含有則返回成功for word in params['q'].split(','):title = [subject['title']]casts = [i['name'] for i in subject['casts']]directors = [i['name'] for i in subject['directors']]total = title + casts + directorsok_(any(word.lower() in i.lower() for i in total),'Check {0} failed!'.format(word.encode('utf-8')))@staticmethoddef check_pageSize(response):# 判斷分頁結果數目是否正確count = response.get('count')start = response.get('start')total = response.get('total')diff = total - startif diff >= count:expectPageSize = countelif count > diff > 0:expectPageSize = diffelse:expectPageSize = 0eq_(expectPageSize, len(response['subjects']), '{0}!={1}'.format(expectPageSize, len(response['subjects'])))

5.4 執行測試

對于上述測試腳本，我們使用nosetests命令可以方便的運行自動化測試，并可使用nose-html-reporting插件生成html格式測試報告。

運行命令如下：

nosetests -v test_doubanSearch.py:test_doubanSearch --with-html --html-report=TestReport.html

5.5 發送郵件報告

測試完成之后，我們可以使用smtplib模塊提供的方法發送html格式測試報告。基本流程是讀取測試報告 -> 添加郵件內容及附件 -> 連接郵件服務器 -> 發送郵件 -> 退出，示例代碼如下：

import smtplibfrom email.mime.text import MIMETextfrom email.mime.multipart import MIMEMultipartdef send_mail():# 讀取測試報告內容with open(report_file, 'r') as f:content = f.read().decode('utf-8')msg = MIMEMultipart('mixed')# 添加郵件內容msg_html = MIMEText(content, 'html', 'utf-8')msg.attach(msg_html)# 添加附件msg_attachment = MIMEText(content, 'html', 'utf-8')msg_attachment["Content-Disposition"] = 'attachment; filename="{0}"'.format(report_file)msg.attach(msg_attachment)msg['Subject'] = mail_subjetmsg['From'] = mail_usermsg['To'] = ';'.join(mail_to)try:# 連接郵件服務器s = smtplib.SMTP(mail_host, 25)# 登陸s.login(mail_user, mail_pwd)# 發送郵件s.sendmail(mail_user, mail_to, msg.as_string())# 退出s.quit()except Exception as e:print "Exceptioin ", e

6. 結果分析

打開nosetests運行完成后生成的測試報告，可以看出本次測試共執行了51條測試用例，50條成功，1條失敗。

失敗的用例可以看到傳入的參數是：{"count": -10, "tag": "喜劇"}，此時返回的結果數與我們的期望結果不一致（count為負數時，期望結果是接口報錯或使用默認值20，但實際返回的結果數目是189。趕緊去給豆瓣提bug啦- -）

7. 完整腳本

豆瓣電影搜索接口的完整自動化測試腳本，我已上傳到的GitHub。下載地址：test_demo/test_douban at master · lovesoo/test_demo · GitHub

下載完成之后，使用如下命令即可進行完整的接口自動化測試并通過郵件發送最終的測試報告：

python test_doubanSearch.py

最終發送測試報告郵件，截圖如下：

最后感謝每一個認真閱讀我文章的人，禮尚往來總是要有的，雖然不是什么很值錢的東西，如果你用得到的話可以直接拿走：

?

這些資料，對于【軟件測試】的朋友來說應該是最全面最完整的備戰倉庫，這個倉庫也陪伴上萬個測試工程師們走過最艱難的路程，希望也能幫助到你！