化測(cè)試實(shí)戰(zhàn)：關(guān)鍵字驅(qū)動(dòng)與持續(xù)集成)
Robot Framework簡(jiǎn)稱 RF是一個(gè)基于 Python 實(shí)現(xiàn)的關(guān)鍵字驅(qū)動(dòng)自動(dòng)化測(cè)試框架。它最大的特點(diǎn)不是“寫(xiě)代碼”而是把測(cè)試用例拆成“關(guān)鍵字組合”讓測(cè)試計(jì)劃和測(cè)試執(zhí)行基本共用同一種語(yǔ)言。不管是 Web UI 自動(dòng)化、接口回歸、移動(dòng)端 App 測(cè)試還是數(shù)據(jù)庫(kù)校驗(yàn)和 RPA 流程RF 都能當(dāng)成一個(gè)通用的自動(dòng)化測(cè)試框架來(lái)用。這篇文章就基于我實(shí)際項(xiàng)目里的使用經(jīng)歷拆開(kāi)講講為什么選它、怎么落地、有哪些坑以及怎么讓它跑得又穩(wěn)又快。1. 先聊方案選型為什么是 Robot Framework 而不是寫(xiě)一堆 Selenium 腳本1.1 它解決的到底是什么問(wèn)題很多測(cè)試團(tuán)隊(duì)最初做 UI 自動(dòng)化時(shí)首選就是 Selenium WebDriver 寫(xiě) Python 腳本。但項(xiàng)目變大以后腳本數(shù)量膨脹問(wèn)題會(huì)集中爆發(fā)沒(méi)有人愿意讀一大段driver.find_element的重復(fù)代碼用例和代碼耦合得太緊業(yè)務(wù)人員根本沒(méi)法參與回歸一次要維護(hù)幾十個(gè)腳本改一個(gè)定位方式要把所有引用它的腳本翻一遍。RF 解決的核心問(wèn)題就是把“測(cè)試設(shè)計(jì)”和“代碼實(shí)現(xiàn)”拆開(kāi)。測(cè)試用例層面不再關(guān)心元素定位、瀏覽器操作這些細(xì)節(jié)只描述“我要做什么”真正的實(shí)現(xiàn)細(xì)節(jié)被封裝成關(guān)鍵字放進(jìn)測(cè)試庫(kù)里。這等于給團(tuán)隊(duì)搭了一條生產(chǎn)線業(yè)務(wù)人員寫(xiě)“工序”會(huì)寫(xiě)代碼的人維護(hù)“工具”。這種關(guān)鍵字驅(qū)動(dòng)模式配合數(shù)據(jù)驅(qū)動(dòng)和標(biāo)簽分組能覆蓋端到端測(cè)試、驗(yàn)收測(cè)試、數(shù)據(jù)校驗(yàn)這些典型場(chǎng)景。還有一個(gè)隱性收益RF 的測(cè)試用例是表格樣式的文本天然適合評(píng)審。比如登錄場(chǎng)景用例直接用自然語(yǔ)言列出“打開(kāi)登錄頁(yè)、輸入賬號(hào)、輸入密碼、點(diǎn)擊登錄、斷言跳轉(zhuǎn)成功”產(chǎn)品經(jīng)理也能看懂哪些場(chǎng)景被覆蓋了。1.2 和 pytest、原生 Selenium 相比它贏在哪pytest 是很優(yōu)秀的框架但它的形態(tài)是純代碼。同樣是斷言、fixture、參數(shù)化pytest 需要寫(xiě) Python 函數(shù)和裝飾器這對(duì)純測(cè)試背景、不太寫(xiě)代碼的同事來(lái)說(shuō)有門(mén)檻。RF 把這一層包裝成了聲明式的表格語(yǔ)法pytest 里一個(gè)登錄參數(shù)化用例需要pytest.mark.parametrize和斷言代碼RF 里用[Template]加一條關(guān)鍵字就能實(shí)現(xiàn)類似效果。pytest 的報(bào)告要額外集成 pytest-html 或 allureRF 自帶output.xml、log.html、report.html三件套執(zhí)行完直接打開(kāi)就能看到每一步的耗時(shí)和截圖。pytest 的 fixture 作用域靠嵌套理解成本高RF 的Suite Setup、Test Setup、Test Teardown一眼就能看明白。當(dāng)然這不是說(shuō) RF 能替代 pytest。pytest 在單元測(cè)試領(lǐng)域、復(fù)雜斷言邏輯、和大規(guī)模代碼庫(kù)集成上更靈活。RF 的強(qiáng)項(xiàng)是端到端、驗(yàn)收、回歸這類“場(chǎng)景驅(qū)動(dòng)”的測(cè)試它的核心競(jìng)爭(zhēng)力是讓非開(kāi)發(fā)人員能看懂用例、參與用例設(shè)計(jì)。1.3 哪些場(chǎng)景千萬(wàn)不要強(qiáng)行用它沒(méi)有萬(wàn)能框架RF 也有明確的能力邊界。我建議在下面這些情況直接放棄 RF對(duì)復(fù)雜算法、數(shù)據(jù)處理邏輯做單元測(cè)試性能要求高的斷言場(chǎng)景用 pytest 或 JUnit 更合適。需要測(cè)試內(nèi)部類、私有方法的底層單元測(cè)試RF 的封裝反而成為障礙。萬(wàn)級(jí)并發(fā)性能測(cè)試RF 做不了交給 Locust 或 JMeter。團(tuán)隊(duì)全員都是資深開(kāi)發(fā)且已經(jīng)有一套沉淀了很久的 pytest 框架沒(méi)必要為了“統(tǒng)一”把棧推倒重來(lái)。判斷標(biāo)準(zhǔn)其實(shí)很簡(jiǎn)單如果你要測(cè)試的對(duì)象是“業(yè)務(wù)邏輯和用戶流程”RF 很合適如果測(cè)試對(duì)象是“函數(shù)內(nèi)部的正確性”別用 RF。2. 理解這套框架先抓住它的骨架2.1 三層模型測(cè)試庫(kù)、關(guān)鍵字、測(cè)試用例RF 的設(shè)計(jì)核心可以拆成三層測(cè)試庫(kù)Library提供底層能力比如SeleniumLibrary提供瀏覽器操作RequestsLibrary提供 HTTP 請(qǐng)求這是“工具箱”。關(guān)鍵字Keyword由測(cè)試庫(kù)里的方法包裝成用戶可讀的動(dòng)詞比如“打開(kāi)瀏覽器”“輸入賬號(hào)”“點(diǎn)擊登錄”這是“操作手”。測(cè)試用例Test Case把關(guān)鍵字按業(yè)務(wù)順序排列加上斷言這是“生產(chǎn)線”。一個(gè)最小用例長(zhǎng)這樣*** Settings *** Library SeleniumLibrary *** Test Cases *** 打開(kāi)站點(diǎn)并驗(yàn)證標(biāo)題 Open Browser https://example.com chrome Title Should Be 示例站點(diǎn) Close Browser在這個(gè)用例里Open Browser是 SeleniumLibrary 提供的關(guān)鍵字Title Should Be是內(nèi)建斷言關(guān)鍵字。你不需要關(guān)心底層怎么實(shí)例化 WebDriver只要告訴它“打開(kāi)、斷言、關(guān)閉”。這層抽象的意義在于底層庫(kù)換了用例不用動(dòng)。比如某天你想從 Selenium 切到 Playwright只要換一個(gè)測(cè)試庫(kù)重新封裝一套同名關(guān)鍵字用例層基本不受影響。2.2 變量、變量文件和作用域切環(huán)境的正確姿勢(shì)RF 的變量有三種形態(tài)標(biāo)量變量${var}表示單個(gè)值是最常用的。列表變量{list}表示一組值適合循環(huán)。字典變量{dict}表示鍵值對(duì)適合傳配置。我強(qiáng)烈建議所有環(huán)境相關(guān)配置不要直接寫(xiě)在用例里而是放到變量文件或者命令行。例如*** Variables *** ${BASE_URL} https://staging.example.com ${BROWSER} chrome *** Test Cases *** 打開(kāi)首頁(yè) Open Browser ${BASE_URL} ${BROWSER}運(yùn)行的時(shí)候可以用--variable覆蓋robot --variable BASE_URL:https://production.example.com tests/這樣做的好處很直接同一套用例測(cè)測(cè)試環(huán)境和生產(chǎn)環(huán)境只改變量不碰用例。更復(fù)雜的做法是用變量文件按環(huán)境分目錄比如env/dev.yaml、env/staging.yaml通過(guò)命令行參數(shù)指定加載哪份配置。2.3 報(bào)告體系log.html 是排查問(wèn)題的主戰(zhàn)場(chǎng)RF 每跑完一次默認(rèn)生成三個(gè)文件output.xml機(jī)器可讀的原始結(jié)果適合 CI 系統(tǒng)解析。log.html每個(gè)步驟、每個(gè)關(guān)鍵字的調(diào)用過(guò)程、參數(shù)、耗時(shí)、截圖是排查問(wèn)題的主戰(zhàn)場(chǎng)。report.html整個(gè)套件的匯總視圖展示通過(guò)失敗率、耗時(shí)分布。實(shí)際項(xiàng)目里我?guī)缀踔欢⒅鴏og.html看。因?yàn)樗涗浟嗣織l用例每個(gè)關(guān)鍵字的具體執(zhí)行情況甚至關(guān)鍵字內(nèi)部的運(yùn)行軌跡。SeleniumLibrary 失敗時(shí)還會(huì)自動(dòng)把瀏覽器截圖嵌到 log 里反正一句話排查問(wèn)題先看 log。如果只想重新生成報(bào)告而不重跑用例可以用rebotrebot --name 回歸報(bào)告 output.xml這在 CI 里特別實(shí)用可以先用--dryrun收集結(jié)果再統(tǒng)一生成漂亮報(bào)告。2.4 標(biāo)簽、執(zhí)行策略和套件組織RF 支持給用例打標(biāo)簽這是組織用例規(guī)模和做選擇執(zhí)行的關(guān)鍵武器。*** Test Cases *** 用戶登錄成功 [Tags] smoke login regression ... 用戶登錄失敗 [Tags] regression login ...跑用例時(shí)可以精準(zhǔn)選擇robot --include smoke tests/ robot --exclude regression tests/ robot --include login --exclude smoke tests/這種標(biāo)簽設(shè)計(jì)的好處在于做冒煙測(cè)試時(shí)不必把整個(gè)回歸套件跑一遍同時(shí)如果有某個(gè)功能掛了可以直接用標(biāo)簽鎖定相關(guān)用例快速?gòu)?fù)現(xiàn)。套件還可以按目錄組織每個(gè)目錄下的__init__.robot可以設(shè)置該套件級(jí)別的 Setup 和 Teardown相當(dāng)于公共前置后置。3. 從零跑通你的第一個(gè) Web UI 自動(dòng)化用例3.1 安裝與前置準(zhǔn)備環(huán)境準(zhǔn)備分為三步按順序來(lái)pip install robotframework pip install robotframework-seleniumlibrary pip install webdriver-managerRF 本身只依賴 Python版本建議 3.8 以上。robotframework-seleniumlibrary是 Web 測(cè)試的官方推薦庫(kù)。但 Selenium 還需要瀏覽器驅(qū)動(dòng)WebDriver 要和瀏覽器版本嚴(yán)格對(duì)應(yīng)這個(gè)最容易踩坑。我的建議是不要手動(dòng)下載 driver直接用webdriver-manager自動(dòng)處理版本匹配。如果你不想用這個(gè)庫(kù)也可以手動(dòng)下載 ChromeDriver 后把路徑加到 PATH 里。驗(yàn)證安裝是否成功在命令行執(zhí)行robot --version python -m robot --version能輸出版本號(hào)就說(shuō)明核心安裝沒(méi)問(wèn)題。隨后用瀏覽器打開(kāi)任意一個(gè)頁(yè)面比如打開(kāi)https://example.com確認(rèn)驅(qū)動(dòng)能正常拉起瀏覽器。3.2 寫(xiě)第一個(gè)用例搜索、斷言、截圖下面是一個(gè)完整的 Web 用例我以某個(gè)測(cè)試站點(diǎn)的搜索功能為例*** Settings *** Library SeleniumLibrary Suite Setup Open Browser ${BASE_URL} chrome Suite Teardown Close All Browsers *** Variables *** ${BASE_URL} https://example.com/search *** Test Cases *** 搜索功能冒煙驗(yàn)證 [Tags] smoke Input Text idsearch-input Robot Framework Click Button idsearch-button Wait Until Element Is Visible css.result-item timeout10s Page Should Contain Robot Framework Capture Page Screenshot這個(gè)用例里面有幾個(gè)關(guān)鍵點(diǎn)需要解釋Suite Setup承擔(dān)了打開(kāi)瀏覽器和打開(kāi)站點(diǎn)的職責(zé)所有用例共用一個(gè)瀏覽器會(huì)話能減少重復(fù)啟動(dòng)瀏覽器的時(shí)間。Input Text和Click Button都是 SeleniumLibrary 提供的關(guān)鍵字第二個(gè)參數(shù)是目標(biāo)值第三個(gè)參數(shù)很多時(shí)候是定位器。我用Wait Until Element Is Visible替代了固定Sleep等待元素可見(jiàn)最多 10 秒元素提前出現(xiàn)就立刻繼續(xù)不浪費(fèi)時(shí)間。Capture Page Screenshot會(huì)把截圖放進(jìn) log.html失敗時(shí)排查很有用。執(zhí)行命令也非常簡(jiǎn)單robot tests/跑完看log.html每一步的耗時(shí)、參數(shù)、截圖都在。3.3 封裝公共關(guān)鍵字讓用例像人話第一次跑通之后大概率會(huì)面臨一個(gè)痛苦每個(gè)用例都在重復(fù)“輸入賬號(hào)、輸入密碼、點(diǎn)擊登錄、等待首頁(yè)加載”。這時(shí)候必須做關(guān)鍵字封裝。新建一個(gè)資源文件resources/login_keywords.robot*** Keywords *** 用戶登錄 [Arguments] ${username} ${password} Input Text idusername ${username} Input Text idpassword ${password} Click Button idlogin-btn Wait Until Page Contains 歡迎回來(lái) timeout10s然后在測(cè)試用例里通過(guò)Resource引入*** Settings *** Resource resources/login_keywords.robot *** Test Cases *** 管理員登錄后進(jìn)入后臺(tái) 用戶登錄 admin_user correct_password Page Should Contain 后臺(tái)管理經(jīng)過(guò)封裝后用例的可讀性大幅提升。產(chǎn)品同事看一眼就能知道這條用例是在驗(yàn)證什么編寫(xiě)用例的人也不用關(guān)心每個(gè)輸入框的 id 是什么。3.4 數(shù)據(jù)驅(qū)動(dòng)改造一條用例跑十組數(shù)據(jù)UI 自動(dòng)化最怕的就是用例數(shù)量膨脹。比如登錄測(cè)試正常、密碼錯(cuò)誤、用戶不存在、賬號(hào)鎖定、密碼為空這些場(chǎng)景如果每個(gè)都復(fù)制一份用例維護(hù)成本直線上升。RF 的[Template]可以解決這個(gè)問(wèn)題*** Test Cases *** 登錄數(shù)據(jù)驅(qū)動(dòng)測(cè)試 [Template] 驗(yàn)證登錄結(jié)果 admin_user correct_pwd 登錄成功 admin_user wrong_pwd 密碼錯(cuò)誤 nobody_user any_pwd 用戶不存在 locked_user correct_pwd 賬號(hào)已鎖定然后定義關(guān)鍵字*** Keywords *** 驗(yàn)證登錄結(jié)果 [Arguments] ${username} ${password} ${expected} 用戶登錄 ${username} ${password} Page Should Contain ${expected}這一招把“每條數(shù)據(jù)一條用例”壓成“一條模板用例多組數(shù)據(jù)”。執(zhí)行時(shí)每一組數(shù)據(jù)會(huì)作為一個(gè)獨(dú)立用例顯示結(jié)果報(bào)告一目了然。如果數(shù)據(jù)量很大還可以把數(shù)據(jù)放到 CSV 或 Excel用 DataDriver 庫(kù)加載實(shí)現(xiàn)完全數(shù)據(jù)、用例分離。4. 項(xiàng)目級(jí)落地目錄分層、自定義庫(kù)和持續(xù)集成4.1 分層目錄設(shè)計(jì)與資源文件項(xiàng)目一旦超過(guò)兩個(gè)模塊我強(qiáng)烈建議按下面的目錄結(jié)構(gòu)組織project/ ├── tests/ │ ├── login_tests.robot │ └── order_tests.robot ├── resources/ │ ├── common_keywords.robot │ ├── login_keywords.robot │ └── order_keywords.robot ├── libraries/ │ └── CustomLibrary.py ├── data/ │ ├── login_data.csv │ └── env/ │ ├── dev.yaml │ └── staging.yaml ├── results/ └── run.pytests/只放用例只關(guān)心業(yè)務(wù)步驟。resources/放關(guān)鍵字是項(xiàng)目的核心資產(chǎn)。libraries/放自定義 Python 庫(kù)。data/放測(cè)試數(shù)據(jù)和環(huán)境配置。results/放執(zhí)行生成的報(bào)告通常會(huì)被 CI 歸檔后清空。很多人一上來(lái)就把用例和關(guān)鍵字混在一個(gè)目錄文件看起來(lái)不少真正維護(hù)時(shí)卻不知道怎么拆。其實(shí)核心準(zhǔn)則就一條用例是“做什么”關(guān)鍵字是“怎么做”配置是“在哪做”三者嚴(yán)格分家。4.2 什么時(shí)候需要寫(xiě)自定義 Python 庫(kù)RF 生態(tài)再?gòu)?qiáng)也總有庫(kù)覆蓋不到的業(yè)務(wù)邏輯比如生成某種特殊格式的訂單號(hào)、調(diào)用內(nèi)部加解密算法、連接某個(gè)數(shù)據(jù)庫(kù)做數(shù)據(jù)清理。這時(shí)候不要硬湊關(guān)鍵字直接寫(xiě)一個(gè) Python 類RF 會(huì)自動(dòng)把類里的方法暴露為關(guān)鍵字。# libraries/OrderLibrary.py import hashlib class OrderLibrary: def generate_order_no(self, prefix, timestamp): raw f{prefix}{timestamp} digest hashlib.md5(raw.encode()).hexdigest()[:8] return f{prefix}-{digest}在用例里引入*** Settings *** Library OrderLibrary *** Test Cases *** 生成訂單號(hào) ${order_no} Generate Order No ORD 202501011030 Should Not Be Empty ${order_no} Log ${order_no}要記住兩點(diǎn)類名和方法名都會(huì)被 RF 轉(zhuǎn)換為空格分隔的關(guān)鍵字比如generate_order_no變成Generate Order No方法的返回值可以被變量直接接收。自定義庫(kù)可以依賴第三方庫(kù)只要在 import 之前已經(jīng)安裝就行。4.3 接入持續(xù)集成命令、退出碼、報(bào)告歸檔RF 接入 CI 的步驟并不復(fù)雜。首先確定執(zhí)行命令推薦統(tǒng)一寫(xiě)成robot --outputdir results --timestampoutputs --include smoke tests/--outputdir指定結(jié)果目錄--timestampoutputs讓每次都生成帶時(shí)間戳的報(bào)告避免覆蓋歷史結(jié)果。執(zhí)行結(jié)束后RF 會(huì)返回退出碼0 表示全部通過(guò)1 表示有失敗用例2 表示執(zhí)行異常、比如測(cè)試套件崩潰。在 CI 流水線里典型的配置步驟是安裝 Python 和依賴。執(zhí)行robot命令。解析output.xml把結(jié)果展示在流水線頁(yè)面。發(fā)布report.html和log.html作為歸檔附件。失敗時(shí)把執(zhí)行日志和截圖打包上傳。這里有個(gè)經(jīng)驗(yàn)不要把整個(gè)工作區(qū)全量打成包只需歸檔results/目錄包含 log.html、report.html、output.xml 和可能的截圖即可。4.4 讓結(jié)果可追溯輸出目錄和時(shí)間戳結(jié)果管理是項(xiàng)目落地中很容易被忽視的一塊。默認(rèn)情況下執(zhí)行命令會(huì)在當(dāng)前目錄生成 output.xml、log.html、report.html這很容易被下一次執(zhí)行覆蓋。我的固定操作是加--outputdir results和--timestampoutputsrobot --outputdir results/20250101_1030 --timestampoutputs tests/這樣每一次執(zhí)行的產(chǎn)物都帶時(shí)間戳即使不建數(shù)據(jù)庫(kù)光靠文件目錄也能追溯到某一次失敗的現(xiàn)場(chǎng)。如果再配合在用例里打上帶有缺陷編號(hào)的標(biāo)簽比如[Tags] bug-1234按 bug 號(hào)查詢歷史執(zhí)行結(jié)果就很方便。5. 測(cè)試庫(kù)選型Web、接口、移動(dòng)端到底怎么配5.1 常用測(cè)試庫(kù)能力對(duì)比測(cè)試庫(kù)適用場(chǎng)景主要能力備注SeleniumLibraryWeb UI瀏覽器操作、元素定位、截圖、等待最穩(wěn)定、社區(qū)資料最多BrowserLibraryWeb UI基于 Playwright支持多標(biāo)簽、更快的執(zhí)行定位更快但 API 風(fēng)格和 Selenium 庫(kù)不同AppiumLibrary移動(dòng)端 App支持 Android/iOS 原生、混合應(yīng)用需要 Appium 服務(wù)在線RequestsLibrary接口測(cè)試HTTP 請(qǐng)求、JSON 斷言、會(huì)話管理輕量適合做接口自動(dòng)化DatabaseLibrary數(shù)據(jù)庫(kù)測(cè)試連接數(shù)據(jù)庫(kù)、執(zhí)行 SQL、校驗(yàn)數(shù)據(jù)常用于測(cè)試數(shù)據(jù)準(zhǔn)備和結(jié)果核對(duì)AutoItLibraryWindows 桌面程序模擬鍵盤(pán)鼠標(biāo)操作小眾需要注意系統(tǒng)環(huán)境我目前在 Web 項(xiàng)目上使用 SeleniumLibrary 為主。雖然 BrowserLibrary 性能更好但團(tuán)隊(duì)對(duì) Selenium 的熟悉程度更高出了問(wèn)題容易排查。接口測(cè)試這塊我一般不會(huì)單獨(dú)為接口寫(xiě) RF 用例而是把接口校驗(yàn)作為 UI 用例的前置步驟或后置校驗(yàn)用 RequestsLibrary 把查詢、創(chuàng)建、清理這些動(dòng)作封裝成關(guān)鍵字。5.2 內(nèi)建庫(kù)才是被低估的寶藏很多人以為 RF 只有 SeleniumLibrary忽略了它自帶的標(biāo)準(zhǔn)庫(kù)。內(nèi)建庫(kù)BuiltIn提供了大量非常實(shí)用的關(guān)鍵字Should Be Equal、Should Contain做斷言。Run Keyword If做條件分支。Repeat Keyword做重試。Set Test Variable在用例間傳遞參數(shù)。還有String庫(kù)幫助處理字符串拼接、正則匹配、去除空格Collections庫(kù)支持列表和字典的操作DateTime庫(kù)處理日期時(shí)間的計(jì)算和格式化。這些庫(kù)不需要額外安裝但實(shí)際使用頻率極高。我舉個(gè)例子之前有個(gè)項(xiàng)目要驗(yàn)證訂單號(hào)格式我直接寫(xiě)${order_no} Generate Order No ORD 202501011030 ${match} Should Match Regexp ${order_no} ^ORD-[a-f0-9]{8}$如果不滿足正則執(zhí)行立刻失敗非常直觀。5.3 等待策略穩(wěn)定性的第一道閘門(mén)UI 自動(dòng)化里90% 的偶然失敗都和等待有關(guān)。RF 里常見(jiàn)的等待方式有三種Sleep固定睡 N 秒。簡(jiǎn)單但低效網(wǎng)絡(luò)一抖就掛。隱式等待Set Selenium Implicit Wait對(duì)每次查找元素生效但無(wú)法應(yīng)對(duì)元素可見(jiàn)性變化。顯式等待Wait Until Element Is Visible、Wait Until Page Contains等條件滿足才繼續(xù)。我實(shí)際項(xiàng)目里的標(biāo)準(zhǔn)做法是請(qǐng)求階段盡量用顯式等待對(duì)于頁(yè)面加載完成的判斷用Wait Until Page Contains或Wait Until Element Is Visible。我還會(huì)把常用等待封裝成一個(gè)帶超時(shí)和重試的關(guān)鍵字統(tǒng)一控制超時(shí)時(shí)間。*** Keywords *** 等待頁(yè)面出現(xiàn) [Arguments] ${text} ${timeout}10s Wait Until Page Contains ${text} timeout${timeout}把超時(shí)統(tǒng)一管理起來(lái)比到處散落Sleep 2s更容易維護(hù)穩(wěn)定性也明顯提升。6. 高頻問(wèn)題與排查技巧實(shí)錄6.1 執(zhí)行前的經(jīng)典報(bào)錯(cuò)報(bào)錯(cuò)信息常見(jiàn)原因處理辦法No keyword with name Open Browser foundSeleniumLibrary 未安裝或未導(dǎo)入檢查pip list是否包含 robotframework-seleniumlibrary并在 Settings 里加Library SeleniumLibraryWebDriverException: Message: chromedriver executable needs to be in PATHChromeDriver 不在 PATH 或版本不匹配使用 webdriver-manager 自動(dòng)匹配TimeoutException元素沒(méi)有在指定時(shí)間出現(xiàn)檢查定位器確認(rèn)頁(yè)面加載策略延長(zhǎng)顯式等待Element not found定位器寫(xiě)錯(cuò)或元素在 iframe 內(nèi)使用開(kāi)發(fā)者工具重新定位iframe 需要先Select Frame中文亂碼文件編碼不是 UTF-8所有 .robot 文件用 UTF-8 編碼保存排查這類問(wèn)題先看 log.html 中具體是哪一步報(bào)錯(cuò)比對(duì)著日志盲猜高效得多。如果失敗在截圖里基本上一眼就能看出是彈窗遮擋、頁(yè)面沒(méi)加載完還是元素位置變化。6.2 我實(shí)際踩過(guò)的幾個(gè)坑第一個(gè)坑是 Chrome 自動(dòng)更新導(dǎo)致版本不匹配。項(xiàng)目跑得好好的某天突然大批量失敗報(bào)錯(cuò)全部是 driver 版本問(wèn)題。后來(lái)我把驅(qū)動(dòng)管理切到webdriver-manager并在 CI 里強(qiáng)制使用固定版本的瀏覽器鏡像這個(gè)問(wèn)題基本消失。第二個(gè)坑是 suite setup 和 test setup 混淆。初期我把登錄放在Test Setup里結(jié)果每條用例登錄一次大量時(shí)間浪費(fèi)在重復(fù)登錄上。排查后發(fā)現(xiàn)登錄操作完全可以放在Suite Setup里一條套件只登錄一次用例之間通過(guò)瀏覽器會(huì)話共享狀態(tài)。當(dāng)然如果你需要用例之間完全隔離就不要這樣做。第三個(gè)坑是變量作用域。我在自定義關(guān)鍵字里用Set Test Variable修改變量結(jié)果影響了后續(xù)用例排查了很久。RF 里變量默認(rèn)是本地作用域Set Test Variable只在當(dāng)前用例有效Set Suite Variable會(huì)對(duì)套件內(nèi)后面所有用例生效。用之前想清楚這個(gè)變量該活多久。6.3 用例提速?gòu)?40 分鐘到 15 分鐘項(xiàng)目剛開(kāi)始時(shí)回歸用例跑完要四十多分鐘最痛苦的是每次用例失敗后重新跑的一大堆前置流程。后來(lái)做了三件事執(zhí)行時(shí)間直接降到 15 分鐘把公共前置流程從每個(gè)用例遷移到Suite Setup避免重復(fù)登錄、重復(fù)創(chuàng)建數(shù)據(jù)。全部固定Sleep改成顯式等待元素提前加載就能提前繼續(xù)。用Pabot做并發(fā)執(zhí)行把多個(gè)套件分配到多個(gè)進(jìn)程并行跑。Pabot 的用法很簡(jiǎn)單pip install robotframework-pabot pabot --outputdir results tests/它會(huì)自動(dòng)掃描套件分進(jìn)程并行執(zhí)行。需要注意的是并行執(zhí)行時(shí)不要讓多個(gè)用例同時(shí)操作同一個(gè)數(shù)據(jù)庫(kù)記錄否則會(huì)出現(xiàn)互相干擾的情況。建議把數(shù)據(jù)隔離到測(cè)試用例級(jí)別或者用唯一的訂單號(hào)前綴。6.4 一點(diǎn)個(gè)人習(xí)慣最后分享幾個(gè)我在實(shí)際項(xiàng)目中堅(jiān)持的習(xí)慣。第一所有 .robot 文件統(tǒng)一用 UTF-8 編碼變量文件用統(tǒng)一的環(huán)境變量文件管理。第二每個(gè)資源文件只放一個(gè)業(yè)務(wù)域的關(guān)鍵字比如登錄、訂單、支付分開(kāi)不要做一個(gè)“萬(wàn)能關(guān)鍵字文件”。第三寫(xiě)用例時(shí)強(qiáng)制帶標(biāo)簽冒煙、回歸、缺陷號(hào)都要清晰這樣后續(xù)按標(biāo)簽選擇執(zhí)行時(shí)才不會(huì)頭疼。還有一個(gè)很小的習(xí)慣每個(gè)用例結(jié)束前要么加一個(gè)斷言關(guān)鍵字要么顯式捕獲截圖絕不留下沒(méi)有任何校驗(yàn)的空跑用例。RF 這套框架的價(jià)值不在于它能寫(xiě)多么炫酷的腳本而在于它讓測(cè)試團(tuán)隊(duì)可以用同一種語(yǔ)言描述業(yè)務(wù)場(chǎng)景、設(shè)計(jì)測(cè)試用例、執(zhí)行回歸、追蹤缺陷。只要把關(guān)鍵字封裝和分層設(shè)計(jì)做好它完全能撐起一個(gè)中型項(xiàng)目的自動(dòng)化測(cè)試體系。 Robot Framework自動(dòng)化測(cè)試實(shí)戰(zhàn)：關(guān)鍵字驅(qū)動(dòng)與持續(xù)集成
Robot Framework簡(jiǎn)稱 RF是一個(gè)基于 Python 實(shí)現(xiàn)的關(guān)鍵字驅(qū)動(dòng)自動(dòng)化測(cè)試框架。它最大的特點(diǎn)不是“寫(xiě)代碼”而是把測(cè)試用例拆成“關(guān)鍵字組合”讓測(cè)試計(jì)劃和測(cè)試執(zhí)行基本共用同一種語(yǔ)言。不管是 Web UI 自動(dòng)化、接口回歸、移動(dòng)端 App 測(cè)試還是數(shù)據(jù)庫(kù)校驗(yàn)和 RPA 流程RF 都能當(dāng)成一個(gè)通用的自動(dòng)化測(cè)試框架來(lái)用。這篇文章就基于我實(shí)際項(xiàng)目里的使用經(jīng)歷拆開(kāi)講講為什么選它、怎么落地、有哪些坑以及怎么讓它跑得又穩(wěn)又快。1. 先聊方案選型為什么是 Robot Framework 而不是寫(xiě)一堆 Selenium 腳本1.1 它解決的到底是什么問(wèn)題很多測(cè)試團(tuán)隊(duì)最初做 UI 自動(dòng)化時(shí)首選就是 Selenium WebDriver 寫(xiě) Python 腳本。但項(xiàng)目變大以后腳本數(shù)量膨脹問(wèn)題會(huì)集中爆發(fā)沒(méi)有人愿意讀一大段driver.find_element的重復(fù)代碼用例和代碼耦合得太緊業(yè)務(wù)人員根本沒(méi)法參與回歸一次要維護(hù)幾十個(gè)腳本改一個(gè)定位方式要把所有引用它的腳本翻一遍。RF 解決的核心問(wèn)題就是把“測(cè)試設(shè)計(jì)”和“代碼實(shí)現(xiàn)”拆開(kāi)。測(cè)試用例層面不再關(guān)心元素定位、瀏覽器操作這些細(xì)節(jié)只描述“我要做什么”真正的實(shí)現(xiàn)細(xì)節(jié)被封裝成關(guān)鍵字放進(jìn)測(cè)試庫(kù)里。這等于給團(tuán)隊(duì)搭了一條生產(chǎn)線業(yè)務(wù)人員寫(xiě)“工序”會(huì)寫(xiě)代碼的人維護(hù)“工具”。這種關(guān)鍵字驅(qū)動(dòng)模式配合數(shù)據(jù)驅(qū)動(dòng)和標(biāo)簽分組能覆蓋端到端測(cè)試、驗(yàn)收測(cè)試、數(shù)據(jù)校驗(yàn)這些典型場(chǎng)景。還有一個(gè)隱性收益RF 的測(cè)試用例是表格樣式的文本天然適合評(píng)審。比如登錄場(chǎng)景用例直接用自然語(yǔ)言列出“打開(kāi)登錄頁(yè)、輸入賬號(hào)、輸入密碼、點(diǎn)擊登錄、斷言跳轉(zhuǎn)成功”產(chǎn)品經(jīng)理也能看懂哪些場(chǎng)景被覆蓋了。1.2 和 pytest、原生 Selenium 相比它贏在哪pytest 是很優(yōu)秀的框架但它的形態(tài)是純代碼。同樣是斷言、fixture、參數(shù)化pytest 需要寫(xiě) Python 函數(shù)和裝飾器這對(duì)純測(cè)試背景、不太寫(xiě)代碼的同事來(lái)說(shuō)有門(mén)檻。RF 把這一層包裝成了聲明式的表格語(yǔ)法pytest 里一個(gè)登錄參數(shù)化用例需要pytest.mark.parametrize和斷言代碼RF 里用[Template]加一條關(guān)鍵字就能實(shí)現(xiàn)類似效果。pytest 的報(bào)告要額外集成 pytest-html 或 allureRF 自帶output.xml、log.html、report.html三件套執(zhí)行完直接打開(kāi)就能看到每一步的耗時(shí)和截圖。pytest 的 fixture 作用域靠嵌套理解成本高RF 的Suite Setup、Test Setup、Test Teardown一眼就能看明白。當(dāng)然這不是說(shuō) RF 能替代 pytest。pytest 在單元測(cè)試領(lǐng)域、復(fù)雜斷言邏輯、和大規(guī)模代碼庫(kù)集成上更靈活。RF 的強(qiáng)項(xiàng)是端到端、驗(yàn)收、回歸這類“場(chǎng)景驅(qū)動(dòng)”的測(cè)試它的核心競(jìng)爭(zhēng)力是讓非開(kāi)發(fā)人員能看懂用例、參與用例設(shè)計(jì)。1.3 哪些場(chǎng)景千萬(wàn)不要強(qiáng)行用它沒(méi)有萬(wàn)能框架RF 也有明確的能力邊界。我建議在下面這些情況直接放棄 RF對(duì)復(fù)雜算法、數(shù)據(jù)處理邏輯做單元測(cè)試性能要求高的斷言場(chǎng)景用 pytest 或 JUnit 更合適。需要測(cè)試內(nèi)部類、私有方法的底層單元測(cè)試RF 的封裝反而成為障礙。萬(wàn)級(jí)并發(fā)性能測(cè)試RF 做不了交給 Locust 或 JMeter。團(tuán)隊(duì)全員都是資深開(kāi)發(fā)且已經(jīng)有一套沉淀了很久的 pytest 框架沒(méi)必要為了“統(tǒng)一”把棧推倒重來(lái)。判斷標(biāo)準(zhǔn)其實(shí)很簡(jiǎn)單如果你要測(cè)試的對(duì)象是“業(yè)務(wù)邏輯和用戶流程”RF 很合適如果測(cè)試對(duì)象是“函數(shù)內(nèi)部的正確性”別用 RF。2. 理解這套框架先抓住它的骨架2.1 三層模型測(cè)試庫(kù)、關(guān)鍵字、測(cè)試用例RF 的設(shè)計(jì)核心可以拆成三層測(cè)試庫(kù)Library提供底層能力比如SeleniumLibrary提供瀏覽器操作RequestsLibrary提供 HTTP 請(qǐng)求這是“工具箱”。關(guān)鍵字Keyword由測(cè)試庫(kù)里的方法包裝成用戶可讀的動(dòng)詞比如“打開(kāi)瀏覽器”“輸入賬號(hào)”“點(diǎn)擊登錄”這是“操作手”。測(cè)試用例Test Case把關(guān)鍵字按業(yè)務(wù)順序排列加上斷言這是“生產(chǎn)線”。一個(gè)最小用例長(zhǎng)這樣*** Settings *** Library SeleniumLibrary *** Test Cases *** 打開(kāi)站點(diǎn)并驗(yàn)證標(biāo)題 Open Browser https://example.com chrome Title Should Be 示例站點(diǎn) Close Browser在這個(gè)用例里Open Browser是 SeleniumLibrary 提供的關(guān)鍵字Title Should Be是內(nèi)建斷言關(guān)鍵字。你不需要關(guān)心底層怎么實(shí)例化 WebDriver只要告訴它“打開(kāi)、斷言、關(guān)閉”。這層抽象的意義在于底層庫(kù)換了用例不用動(dòng)。比如某天你想從 Selenium 切到 Playwright只要換一個(gè)測(cè)試庫(kù)重新封裝一套同名關(guān)鍵字用例層基本不受影響。2.2 變量、變量文件和作用域切環(huán)境的正確姿勢(shì)RF 的變量有三種形態(tài)標(biāo)量變量${var}表示單個(gè)值是最常用的。列表變量{list}表示一組值適合循環(huán)。字典變量{dict}表示鍵值對(duì)適合傳配置。我強(qiáng)烈建議所有環(huán)境相關(guān)配置不要直接寫(xiě)在用例里而是放到變量文件或者命令行。例如*** Variables *** ${BASE_URL} https://staging.example.com ${BROWSER} chrome *** Test Cases *** 打開(kāi)首頁(yè) Open Browser ${BASE_URL} ${BROWSER}運(yùn)行的時(shí)候可以用--variable覆蓋robot --variable BASE_URL:https://production.example.com tests/這樣做的好處很直接同一套用例測(cè)測(cè)試環(huán)境和生產(chǎn)環(huán)境只改變量不碰用例。更復(fù)雜的做法是用變量文件按環(huán)境分目錄比如env/dev.yaml、env/staging.yaml通過(guò)命令行參數(shù)指定加載哪份配置。2.3 報(bào)告體系log.html 是排查問(wèn)題的主戰(zhàn)場(chǎng)RF 每跑完一次默認(rèn)生成三個(gè)文件output.xml機(jī)器可讀的原始結(jié)果適合 CI 系統(tǒng)解析。log.html每個(gè)步驟、每個(gè)關(guān)鍵字的調(diào)用過(guò)程、參數(shù)、耗時(shí)、截圖是排查問(wèn)題的主戰(zhàn)場(chǎng)。report.html整個(gè)套件的匯總視圖展示通過(guò)失敗率、耗時(shí)分布。實(shí)際項(xiàng)目里我?guī)缀踔欢⒅鴏og.html看。因?yàn)樗涗浟嗣織l用例每個(gè)關(guān)鍵字的具體執(zhí)行情況甚至關(guān)鍵字內(nèi)部的運(yùn)行軌跡。SeleniumLibrary 失敗時(shí)還會(huì)自動(dòng)把瀏覽器截圖嵌到 log 里反正一句話排查問(wèn)題先看 log。如果只想重新生成報(bào)告而不重跑用例可以用rebotrebot --name 回歸報(bào)告 output.xml這在 CI 里特別實(shí)用可以先用--dryrun收集結(jié)果再統(tǒng)一生成漂亮報(bào)告。2.4 標(biāo)簽、執(zhí)行策略和套件組織RF 支持給用例打標(biāo)簽這是組織用例規(guī)模和做選擇執(zhí)行的關(guān)鍵武器。*** Test Cases *** 用戶登錄成功 [Tags] smoke login regression ... 用戶登錄失敗 [Tags] regression login ...跑用例時(shí)可以精準(zhǔn)選擇robot --include smoke tests/ robot --exclude regression tests/ robot --include login --exclude smoke tests/這種標(biāo)簽設(shè)計(jì)的好處在于做冒煙測(cè)試時(shí)不必把整個(gè)回歸套件跑一遍同時(shí)如果有某個(gè)功能掛了可以直接用標(biāo)簽鎖定相關(guān)用例快速?gòu)?fù)現(xiàn)。套件還可以按目錄組織每個(gè)目錄下的__init__.robot可以設(shè)置該套件級(jí)別的 Setup 和 Teardown相當(dāng)于公共前置后置。3. 從零跑通你的第一個(gè) Web UI 自動(dòng)化用例3.1 安裝與前置準(zhǔn)備環(huán)境準(zhǔn)備分為三步按順序來(lái)pip install robotframework pip install robotframework-seleniumlibrary pip install webdriver-managerRF 本身只依賴 Python版本建議 3.8 以上。robotframework-seleniumlibrary是 Web 測(cè)試的官方推薦庫(kù)。但 Selenium 還需要瀏覽器驅(qū)動(dòng)WebDriver 要和瀏覽器版本嚴(yán)格對(duì)應(yīng)這個(gè)最容易踩坑。我的建議是不要手動(dòng)下載 driver直接用webdriver-manager自動(dòng)處理版本匹配。如果你不想用這個(gè)庫(kù)也可以手動(dòng)下載 ChromeDriver 后把路徑加到 PATH 里。驗(yàn)證安裝是否成功在命令行執(zhí)行robot --version python -m robot --version能輸出版本號(hào)就說(shuō)明核心安裝沒(méi)問(wèn)題。隨后用瀏覽器打開(kāi)任意一個(gè)頁(yè)面比如打開(kāi)https://example.com確認(rèn)驅(qū)動(dòng)能正常拉起瀏覽器。3.2 寫(xiě)第一個(gè)用例搜索、斷言、截圖下面是一個(gè)完整的 Web 用例我以某個(gè)測(cè)試站點(diǎn)的搜索功能為例*** Settings *** Library SeleniumLibrary Suite Setup Open Browser ${BASE_URL} chrome Suite Teardown Close All Browsers *** Variables *** ${BASE_URL} https://example.com/search *** Test Cases *** 搜索功能冒煙驗(yàn)證 [Tags] smoke Input Text idsearch-input Robot Framework Click Button idsearch-button Wait Until Element Is Visible css.result-item timeout10s Page Should Contain Robot Framework Capture Page Screenshot這個(gè)用例里面有幾個(gè)關(guān)鍵點(diǎn)需要解釋Suite Setup承擔(dān)了打開(kāi)瀏覽器和打開(kāi)站點(diǎn)的職責(zé)所有用例共用一個(gè)瀏覽器會(huì)話能減少重復(fù)啟動(dòng)瀏覽器的時(shí)間。Input Text和Click Button都是 SeleniumLibrary 提供的關(guān)鍵字第二個(gè)參數(shù)是目標(biāo)值第三個(gè)參數(shù)很多時(shí)候是定位器。我用Wait Until Element Is Visible替代了固定Sleep等待元素可見(jiàn)最多 10 秒元素提前出現(xiàn)就立刻繼續(xù)不浪費(fèi)時(shí)間。Capture Page Screenshot會(huì)把截圖放進(jìn) log.html失敗時(shí)排查很有用。執(zhí)行命令也非常簡(jiǎn)單robot tests/跑完看log.html每一步的耗時(shí)、參數(shù)、截圖都在。3.3 封裝公共關(guān)鍵字讓用例像人話第一次跑通之后大概率會(huì)面臨一個(gè)痛苦每個(gè)用例都在重復(fù)“輸入賬號(hào)、輸入密碼、點(diǎn)擊登錄、等待首頁(yè)加載”。這時(shí)候必須做關(guān)鍵字封裝。新建一個(gè)資源文件resources/login_keywords.robot*** Keywords *** 用戶登錄 [Arguments] ${username} ${password} Input Text idusername ${username} Input Text idpassword ${password} Click Button idlogin-btn Wait Until Page Contains 歡迎回來(lái) timeout10s然后在測(cè)試用例里通過(guò)Resource引入*** Settings *** Resource resources/login_keywords.robot *** Test Cases *** 管理員登錄后進(jìn)入后臺(tái) 用戶登錄 admin_user correct_password Page Should Contain 后臺(tái)管理經(jīng)過(guò)封裝后用例的可讀性大幅提升。產(chǎn)品同事看一眼就能知道這條用例是在驗(yàn)證什么編寫(xiě)用例的人也不用關(guān)心每個(gè)輸入框的 id 是什么。3.4 數(shù)據(jù)驅(qū)動(dòng)改造一條用例跑十組數(shù)據(jù)UI 自動(dòng)化最怕的就是用例數(shù)量膨脹。比如登錄測(cè)試正常、密碼錯(cuò)誤、用戶不存在、賬號(hào)鎖定、密碼為空這些場(chǎng)景如果每個(gè)都復(fù)制一份用例維護(hù)成本直線上升。RF 的[Template]可以解決這個(gè)問(wèn)題*** Test Cases *** 登錄數(shù)據(jù)驅(qū)動(dòng)測(cè)試 [Template] 驗(yàn)證登錄結(jié)果 admin_user correct_pwd 登錄成功 admin_user wrong_pwd 密碼錯(cuò)誤 nobody_user any_pwd 用戶不存在 locked_user correct_pwd 賬號(hào)已鎖定然后定義關(guān)鍵字*** Keywords *** 驗(yàn)證登錄結(jié)果 [Arguments] ${username} ${password} ${expected} 用戶登錄 ${username} ${password} Page Should Contain ${expected}這一招把“每條數(shù)據(jù)一條用例”壓成“一條模板用例多組數(shù)據(jù)”。執(zhí)行時(shí)每一組數(shù)據(jù)會(huì)作為一個(gè)獨(dú)立用例顯示結(jié)果報(bào)告一目了然。如果數(shù)據(jù)量很大還可以把數(shù)據(jù)放到 CSV 或 Excel用 DataDriver 庫(kù)加載實(shí)現(xiàn)完全數(shù)據(jù)、用例分離。4. 項(xiàng)目級(jí)落地目錄分層、自定義庫(kù)和持續(xù)集成4.1 分層目錄設(shè)計(jì)與資源文件項(xiàng)目一旦超過(guò)兩個(gè)模塊我強(qiáng)烈建議按下面的目錄結(jié)構(gòu)組織project/ ├── tests/ │ ├── login_tests.robot │ └── order_tests.robot ├── resources/ │ ├── common_keywords.robot │ ├── login_keywords.robot │ └── order_keywords.robot ├── libraries/ │ └── CustomLibrary.py ├── data/ │ ├── login_data.csv │ └── env/ │ ├── dev.yaml │ └── staging.yaml ├── results/ └── run.pytests/只放用例只關(guān)心業(yè)務(wù)步驟。resources/放關(guān)鍵字是項(xiàng)目的核心資產(chǎn)。libraries/放自定義 Python 庫(kù)。data/放測(cè)試數(shù)據(jù)和環(huán)境配置。results/放執(zhí)行生成的報(bào)告通常會(huì)被 CI 歸檔后清空。很多人一上來(lái)就把用例和關(guān)鍵字混在一個(gè)目錄文件看起來(lái)不少真正維護(hù)時(shí)卻不知道怎么拆。其實(shí)核心準(zhǔn)則就一條用例是“做什么”關(guān)鍵字是“怎么做”配置是“在哪做”三者嚴(yán)格分家。4.2 什么時(shí)候需要寫(xiě)自定義 Python 庫(kù)RF 生態(tài)再?gòu)?qiáng)也總有庫(kù)覆蓋不到的業(yè)務(wù)邏輯比如生成某種特殊格式的訂單號(hào)、調(diào)用內(nèi)部加解密算法、連接某個(gè)數(shù)據(jù)庫(kù)做數(shù)據(jù)清理。這時(shí)候不要硬湊關(guān)鍵字直接寫(xiě)一個(gè) Python 類RF 會(huì)自動(dòng)把類里的方法暴露為關(guān)鍵字。# libraries/OrderLibrary.py import hashlib class OrderLibrary: def generate_order_no(self, prefix, timestamp): raw f{prefix}{timestamp} digest hashlib.md5(raw.encode()).hexdigest()[:8] return f{prefix}-{digest}在用例里引入*** Settings *** Library OrderLibrary *** Test Cases *** 生成訂單號(hào) ${order_no} Generate Order No ORD 202501011030 Should Not Be Empty ${order_no} Log ${order_no}要記住兩點(diǎn)類名和方法名都會(huì)被 RF 轉(zhuǎn)換為空格分隔的關(guān)鍵字比如generate_order_no變成Generate Order No方法的返回值可以被變量直接接收。自定義庫(kù)可以依賴第三方庫(kù)只要在 import 之前已經(jīng)安裝就行。4.3 接入持續(xù)集成命令、退出碼、報(bào)告歸檔RF 接入 CI 的步驟并不復(fù)雜。首先確定執(zhí)行命令推薦統(tǒng)一寫(xiě)成robot --outputdir results --timestampoutputs --include smoke tests/--outputdir指定結(jié)果目錄--timestampoutputs讓每次都生成帶時(shí)間戳的報(bào)告避免覆蓋歷史結(jié)果。執(zhí)行結(jié)束后RF 會(huì)返回退出碼0 表示全部通過(guò)1 表示有失敗用例2 表示執(zhí)行異常、比如測(cè)試套件崩潰。在 CI 流水線里典型的配置步驟是安裝 Python 和依賴。執(zhí)行robot命令。解析output.xml把結(jié)果展示在流水線頁(yè)面。發(fā)布report.html和log.html作為歸檔附件。失敗時(shí)把執(zhí)行日志和截圖打包上傳。這里有個(gè)經(jīng)驗(yàn)不要把整個(gè)工作區(qū)全量打成包只需歸檔results/目錄包含 log.html、report.html、output.xml 和可能的截圖即可。4.4 讓結(jié)果可追溯輸出目錄和時(shí)間戳結(jié)果管理是項(xiàng)目落地中很容易被忽視的一塊。默認(rèn)情況下執(zhí)行命令會(huì)在當(dāng)前目錄生成 output.xml、log.html、report.html這很容易被下一次執(zhí)行覆蓋。我的固定操作是加--outputdir results和--timestampoutputsrobot --outputdir results/20250101_1030 --timestampoutputs tests/這樣每一次執(zhí)行的產(chǎn)物都帶時(shí)間戳即使不建數(shù)據(jù)庫(kù)光靠文件目錄也能追溯到某一次失敗的現(xiàn)場(chǎng)。如果再配合在用例里打上帶有缺陷編號(hào)的標(biāo)簽比如[Tags] bug-1234按 bug 號(hào)查詢歷史執(zhí)行結(jié)果就很方便。5. 測(cè)試庫(kù)選型Web、接口、移動(dòng)端到底怎么配5.1 常用測(cè)試庫(kù)能力對(duì)比測(cè)試庫(kù)適用場(chǎng)景主要能力備注SeleniumLibraryWeb UI瀏覽器操作、元素定位、截圖、等待最穩(wěn)定、社區(qū)資料最多BrowserLibraryWeb UI基于 Playwright支持多標(biāo)簽、更快的執(zhí)行定位更快但 API 風(fēng)格和 Selenium 庫(kù)不同AppiumLibrary移動(dòng)端 App支持 Android/iOS 原生、混合應(yīng)用需要 Appium 服務(wù)在線RequestsLibrary接口測(cè)試HTTP 請(qǐng)求、JSON 斷言、會(huì)話管理輕量適合做接口自動(dòng)化DatabaseLibrary數(shù)據(jù)庫(kù)測(cè)試連接數(shù)據(jù)庫(kù)、執(zhí)行 SQL、校驗(yàn)數(shù)據(jù)常用于測(cè)試數(shù)據(jù)準(zhǔn)備和結(jié)果核對(duì)AutoItLibraryWindows 桌面程序模擬鍵盤(pán)鼠標(biāo)操作小眾需要注意系統(tǒng)環(huán)境我目前在 Web 項(xiàng)目上使用 SeleniumLibrary 為主。雖然 BrowserLibrary 性能更好但團(tuán)隊(duì)對(duì) Selenium 的熟悉程度更高出了問(wèn)題容易排查。接口測(cè)試這塊我一般不會(huì)單獨(dú)為接口寫(xiě) RF 用例而是把接口校驗(yàn)作為 UI 用例的前置步驟或后置校驗(yàn)用 RequestsLibrary 把查詢、創(chuàng)建、清理這些動(dòng)作封裝成關(guān)鍵字。5.2 內(nèi)建庫(kù)才是被低估的寶藏很多人以為 RF 只有 SeleniumLibrary忽略了它自帶的標(biāo)準(zhǔn)庫(kù)。內(nèi)建庫(kù)BuiltIn提供了大量非常實(shí)用的關(guān)鍵字Should Be Equal、Should Contain做斷言。Run Keyword If做條件分支。Repeat Keyword做重試。Set Test Variable在用例間傳遞參數(shù)。還有String庫(kù)幫助處理字符串拼接、正則匹配、去除空格Collections庫(kù)支持列表和字典的操作DateTime庫(kù)處理日期時(shí)間的計(jì)算和格式化。這些庫(kù)不需要額外安裝但實(shí)際使用頻率極高。我舉個(gè)例子之前有個(gè)項(xiàng)目要驗(yàn)證訂單號(hào)格式我直接寫(xiě)${order_no} Generate Order No ORD 202501011030 ${match} Should Match Regexp ${order_no} ^ORD-[a-f0-9]{8}$如果不滿足正則執(zhí)行立刻失敗非常直觀。5.3 等待策略穩(wěn)定性的第一道閘門(mén)UI 自動(dòng)化里90% 的偶然失敗都和等待有關(guān)。RF 里常見(jiàn)的等待方式有三種Sleep固定睡 N 秒。簡(jiǎn)單但低效網(wǎng)絡(luò)一抖就掛。隱式等待Set Selenium Implicit Wait對(duì)每次查找元素生效但無(wú)法應(yīng)對(duì)元素可見(jiàn)性變化。顯式等待Wait Until Element Is Visible、Wait Until Page Contains等條件滿足才繼續(xù)。我實(shí)際項(xiàng)目里的標(biāo)準(zhǔn)做法是請(qǐng)求階段盡量用顯式等待對(duì)于頁(yè)面加載完成的判斷用Wait Until Page Contains或Wait Until Element Is Visible。我還會(huì)把常用等待封裝成一個(gè)帶超時(shí)和重試的關(guān)鍵字統(tǒng)一控制超時(shí)時(shí)間。*** Keywords *** 等待頁(yè)面出現(xiàn) [Arguments] ${text} ${timeout}10s Wait Until Page Contains ${text} timeout${timeout}把超時(shí)統(tǒng)一管理起來(lái)比到處散落Sleep 2s更容易維護(hù)穩(wěn)定性也明顯提升。6. 高頻問(wèn)題與排查技巧實(shí)錄6.1 執(zhí)行前的經(jīng)典報(bào)錯(cuò)報(bào)錯(cuò)信息常見(jiàn)原因處理辦法No keyword with name Open Browser foundSeleniumLibrary 未安裝或未導(dǎo)入檢查pip list是否包含 robotframework-seleniumlibrary并在 Settings 里加Library SeleniumLibraryWebDriverException: Message: chromedriver executable needs to be in PATHChromeDriver 不在 PATH 或版本不匹配使用 webdriver-manager 自動(dòng)匹配TimeoutException元素沒(méi)有在指定時(shí)間出現(xiàn)檢查定位器確認(rèn)頁(yè)面加載策略延長(zhǎng)顯式等待Element not found定位器寫(xiě)錯(cuò)或元素在 iframe 內(nèi)使用開(kāi)發(fā)者工具重新定位iframe 需要先Select Frame中文亂碼文件編碼不是 UTF-8所有 .robot 文件用 UTF-8 編碼保存排查這類問(wèn)題先看 log.html 中具體是哪一步報(bào)錯(cuò)比對(duì)著日志盲猜高效得多。如果失敗在截圖里基本上一眼就能看出是彈窗遮擋、頁(yè)面沒(méi)加載完還是元素位置變化。6.2 我實(shí)際踩過(guò)的幾個(gè)坑第一個(gè)坑是 Chrome 自動(dòng)更新導(dǎo)致版本不匹配。項(xiàng)目跑得好好的某天突然大批量失敗報(bào)錯(cuò)全部是 driver 版本問(wèn)題。后來(lái)我把驅(qū)動(dòng)管理切到webdriver-manager并在 CI 里強(qiáng)制使用固定版本的瀏覽器鏡像這個(gè)問(wèn)題基本消失。第二個(gè)坑是 suite setup 和 test setup 混淆。初期我把登錄放在Test Setup里結(jié)果每條用例登錄一次大量時(shí)間浪費(fèi)在重復(fù)登錄上。排查后發(fā)現(xiàn)登錄操作完全可以放在Suite Setup里一條套件只登錄一次用例之間通過(guò)瀏覽器會(huì)話共享狀態(tài)。當(dāng)然如果你需要用例之間完全隔離就不要這樣做。第三個(gè)坑是變量作用域。我在自定義關(guān)鍵字里用Set Test Variable修改變量結(jié)果影響了后續(xù)用例排查了很久。RF 里變量默認(rèn)是本地作用域Set Test Variable只在當(dāng)前用例有效Set Suite Variable會(huì)對(duì)套件內(nèi)后面所有用例生效。用之前想清楚這個(gè)變量該活多久。6.3 用例提速?gòu)?40 分鐘到 15 分鐘項(xiàng)目剛開(kāi)始時(shí)回歸用例跑完要四十多分鐘最痛苦的是每次用例失敗后重新跑的一大堆前置流程。后來(lái)做了三件事執(zhí)行時(shí)間直接降到 15 分鐘把公共前置流程從每個(gè)用例遷移到Suite Setup避免重復(fù)登錄、重復(fù)創(chuàng)建數(shù)據(jù)。全部固定Sleep改成顯式等待元素提前加載就能提前繼續(xù)。用Pabot做并發(fā)執(zhí)行把多個(gè)套件分配到多個(gè)進(jìn)程并行跑。Pabot 的用法很簡(jiǎn)單pip install robotframework-pabot pabot --outputdir results tests/它會(huì)自動(dòng)掃描套件分進(jìn)程并行執(zhí)行。需要注意的是并行執(zhí)行時(shí)不要讓多個(gè)用例同時(shí)操作同一個(gè)數(shù)據(jù)庫(kù)記錄否則會(huì)出現(xiàn)互相干擾的情況。建議把數(shù)據(jù)隔離到測(cè)試用例級(jí)別或者用唯一的訂單號(hào)前綴。6.4 一點(diǎn)個(gè)人習(xí)慣最后分享幾個(gè)我在實(shí)際項(xiàng)目中堅(jiān)持的習(xí)慣。第一所有 .robot 文件統(tǒng)一用 UTF-8 編碼變量文件用統(tǒng)一的環(huán)境變量文件管理。第二每個(gè)資源文件只放一個(gè)業(yè)務(wù)域的關(guān)鍵字比如登錄、訂單、支付分開(kāi)不要做一個(gè)“萬(wàn)能關(guān)鍵字文件”。第三寫(xiě)用例時(shí)強(qiáng)制帶標(biāo)簽冒煙、回歸、缺陷號(hào)都要清晰這樣后續(xù)按標(biāo)簽選擇執(zhí)行時(shí)才不會(huì)頭疼。還有一個(gè)很小的習(xí)慣每個(gè)用例結(jié)束前要么加一個(gè)斷言關(guān)鍵字要么顯式捕獲截圖絕不留下沒(méi)有任何校驗(yàn)的空跑用例。RF 這套框架的價(jià)值不在于它能寫(xiě)多么炫酷的腳本而在于它讓測(cè)試團(tuán)隊(duì)可以用同一種語(yǔ)言描述業(yè)務(wù)場(chǎng)景、設(shè)計(jì)測(cè)試用例、執(zhí)行回歸、追蹤缺陷。只要把關(guān)鍵字封裝和分層設(shè)計(jì)做好它完全能撐起一個(gè)中型項(xiàng)目的自動(dòng)化測(cè)試體系。