仿QQ音樂桌面客戶端——測試報告一、項目介紹1.1 項目背景QQ音樂是騰訊公司推出的一款網(wǎng)絡(luò)音樂服務(wù)產(chǎn)品提供海量音樂在線試聽、新歌熱歌首發(fā)、歌詞翻譯、手機鈴聲下載、高品質(zhì)無損音樂試聽、正版音樂下載、免費空間背景音樂設(shè)置、MV觀看等功能。桌面客戶端作為QQ音樂的重要終端承載了用戶日常聽歌、管理本地音樂、收藏歌單等核心場景。隨著QQ音樂桌面客戶端功能的不斷迭代客戶端的穩(wěn)定性、功能完整性和用戶體驗直接影響著億萬用戶的使用感受。為確保客戶端在發(fā)布前各項功能正常運行、界面布局合理、性能表現(xiàn)達標我們開展了本次全面的測試工作。本次測試以QQ音樂Windows桌面客戶端為測試對象覆蓋功能測試、UI布局測試、性能測試三大維度通過手工測試與自動化測試相結(jié)合的方式系統(tǒng)性地保障客戶端質(zhì)量。1.2 測試目的本次測試圍繞以下核心目標展開1.2.1 功能正確性與完整性驗證QQ音樂桌面客戶端的核心功能模塊是否正常運行包括客戶端啟動、左側(cè)導(dǎo)航切換、本地下載管理、我喜歡收藏、底部播放控制、窗口操作等。確保各功能模塊的業(yè)務(wù)邏輯正確模塊間銜接無斷點符合用戶實際使用習慣。1.2.2 用戶體驗與界面一致性驗證客戶端界面布局是否合理控件在不同窗口大小下是否自適應(yīng)排列有無重疊、越界、文字截斷等問題。驗證選中高亮、收藏圖標、音質(zhì)標簽等視覺元素是否正常渲染確保用戶體驗流暢一致。1.2.3 性能與穩(wěn)定性驗證客戶端在高頻操作場景下的性能表現(xiàn)包括高頻切歌時的CPU和內(nèi)存占用、大量本地歌曲加載耗時、長時間持續(xù)播放時的內(nèi)存泄漏情況。確保客戶端在長時間運行和高頻操作下保持穩(wěn)定無崩潰、無明顯性能衰減。1.2.4 自動化測試體系建設(shè)搭建基于Python pywinauto的桌面端UI自動化測試框架采用POMPage Object Model三層架構(gòu)實現(xiàn)核心功能的自動化回歸測試提高測試效率降低人工回歸成本。1.3 測試環(huán)境項目配置操作系統(tǒng)Windows 10 / Windows 11測試對象QQ音樂 Windows桌面客戶端自動化語言Python 3.9GUI自動化框架pywinauto 0.6.8UIA backend測試框架pytest 8.3.2性能監(jiān)控psutil 5.9.0測試報告Allure 2.13.5 pytest-html 4.2.0控件探查工具UIspy / inspect.exe二、設(shè)計測試用例測試用例設(shè)計錨定需求分析結(jié)合等價類劃分與邊界值分析再通過場景測試模擬用戶實際操作。本次測試用例分為三大類功能測試、UI布局測試、性能測試。2.1 功能測試用例功能測試覆蓋客戶端的核心功能模塊共設(shè)計9個模塊、37個測試用例測試模塊用例數(shù)測試內(nèi)容冒煙測試3應(yīng)用啟動、截圖功能、窗口標題校驗導(dǎo)航測試5主頁加載、左側(cè)導(dǎo)航切換、返回推薦、導(dǎo)航不中斷播放、我的音樂導(dǎo)航播放器測試8播放暫停、上下曲切換、播放狀態(tài)、進度條拖拽、音量按鈕、音量調(diào)節(jié)、播放模式切換、播放信息展示搜索框測試4搜索框存在性、輸入功能、焦點獲取、導(dǎo)航后持久化本地下載頁7頁面加載、列表表頭、列表有歌曲、添加本地歌曲、歌曲信息、雙擊播放、播放全部我喜歡頁8頁面加載、列表展示、收藏歌曲、雙擊播放、播放全部、取消收藏、收藏多首、收藏信息校驗窗口操作2最大化還原、最小化還原2.2 UI布局測試用例UI布局測試驗證客戶端界面在不同窗口大小下的自適應(yīng)表現(xiàn)共設(shè)計4個測試用例用例名稱測試內(nèi)容窗口縮放控件無重疊縮放窗口到1024x768、1280x720、1600x900驗證底部播放欄控件無重疊、無越界選中歌曲高亮樣式點擊列表歌曲驗證選中狀態(tài)截圖保存供人工確認高亮樣式收藏圖標與音質(zhì)標簽渲染驗證本地下載列表中收藏圖標紅心、音質(zhì)標簽SQ/HQ正常渲染播放控件自適應(yīng)布局拉伸窗口寬度到1000/1200/1400/1800驗證播放控件保持水平排列、間距合理2.3 性能測試用例性能測試驗證客戶端在高頻操作和長時間運行下的性能表現(xiàn)共設(shè)計3個測試用例用例名稱測試內(nèi)容性能指標高頻切歌CPU/內(nèi)存監(jiān)控連續(xù)切歌20次每5次采樣一次CPU和內(nèi)存平均CPU≤80%峰值CPU≤90%內(nèi)存增長≤100MB頁面加載耗時統(tǒng)計從推薦頁導(dǎo)航到本地下載頁測量列表元素出現(xiàn)耗時重復(fù)5次取平均平均加載耗時≤5000ms長時間播放內(nèi)存泄漏持續(xù)播放2分鐘每10秒采樣一次內(nèi)存前后半段內(nèi)存增長率對比內(nèi)存增長率≤10%最終內(nèi)存≤初始內(nèi)存150%三、手動測試自動化測試已覆蓋客戶端啟動、導(dǎo)航切換、播放控制、本地下載、我喜歡、窗口操作、UI布局、性能等46個可量化的功能點。手動測試聚焦于自動化無法覆蓋的視覺細節(jié)、交互體驗、異常邊界場景與自動化測試形成互補不重復(fù)覆蓋。3.1 客戶端啟動與窗口視覺編號測試項目測試步驟預(yù)期結(jié)果實際結(jié)果結(jié)論MT-01啟動加載過程雙擊QQ音樂快捷方式觀察從啟動到主窗口完全加載的過程啟動后無閃退、無白屏主窗口在合理時間內(nèi)加載完成左側(cè)導(dǎo)航、中間內(nèi)容區(qū)、底部播放欄三欄布局完整啟動正常三欄布局完整展示通過MT-02主窗口視覺布局觀察主窗口整體布局比例左側(cè)導(dǎo)航欄寬度適中中間內(nèi)容區(qū)占據(jù)主要空間底部播放欄高度合理三欄比例協(xié)調(diào)無內(nèi)容溢出或大面積空白三欄比例協(xié)調(diào)布局正常通過MT-03窗口拖拽移動按住窗口標題欄拖拽移動窗口窗口跟隨鼠標平滑移動移動過程中無卡頓、無殘影窗口拖拽平滑無卡頓通過MT-04窗口邊緣拖拽調(diào)整大小拖拽窗口右邊緣調(diào)整寬度拖拽下邊緣調(diào)整高度拖拽過程中顯示窗口大小預(yù)覽松開后窗口尺寸更新內(nèi)容區(qū)自適應(yīng)調(diào)整窗口大小調(diào)整正常內(nèi)容區(qū)自適應(yīng)通過【MT-01——MT-04客戶端啟動與窗口視覺】3.2 左側(cè)導(dǎo)航欄交互體驗編號測試項目測試步驟預(yù)期結(jié)果實際結(jié)果結(jié)論MT-05導(dǎo)航項懸停效果鼠標懸停在左側(cè)導(dǎo)航項推薦/排行榜/歌手等上不點擊懸停項背景色或文字顏色發(fā)生變化給出視覺反饋懸停時有顏色變化反饋通過MT-06導(dǎo)航項選中狀態(tài)點擊某個導(dǎo)航項觀察選中樣式選中項高亮顯示背景色/文字顏色與未選中項有明顯區(qū)別可能伴有左側(cè)指示條選中項高亮明顯有指示條通過MT-07導(dǎo)航切換過渡連續(xù)點擊不同導(dǎo)航項觀察頁面切換過程頁面切換流暢無明顯卡頓或白屏閃爍切換后新頁面內(nèi)容加載完整切換流暢內(nèi)容加載正常通過MT-08導(dǎo)航圖標與文字對齊觀察左側(cè)導(dǎo)航項的圖標與文字排版圖標與文字水平居中對齊間距均勻無錯位圖標文字對齊正常通過【MT-05~MT-08 截圖位置左側(cè)導(dǎo)航欄交互體驗】3.3 本地下載頁面視覺與交互編號測試項目測試步驟預(yù)期結(jié)果實際結(jié)果結(jié)論MT-09列表表頭樣式進表頭展示歌名、歌手、專輯、音質(zhì)等列名列寬分配合理文字對齊統(tǒng)一表頭列名完整列寬合理通過MT-10歌曲行懸停效果鼠標懸停在某首歌曲行上不點擊懸停行背景色發(fā)生變化與其他行區(qū)分開懸停行背景色變化通過MT-11歌曲行選中效果單擊某首歌曲行觀察選中樣式選中行高亮顯示背景色明顯區(qū)別于未選中行選中行高亮明顯通過MT-12紅心收藏圖標狀態(tài)觀察未收藏歌曲和已收藏歌曲的紅心圖標未收藏時紅心為空心/灰色已收藏時紅心為實心/紅色兩種狀態(tài)視覺區(qū)分明顯未收藏灰色已收藏紅色區(qū)分明顯通過MT-13紅心懸停效果鼠標懸停在紅心圖標上紅心圖標有視覺反饋顏色加深或放大提示可點擊懸停時有視覺反饋通過MT-14音質(zhì)標簽樣式觀察歌曲行中的音質(zhì)標簽SQ/HQ/無損等音質(zhì)標簽以小標簽形式展示在歌名旁不同音質(zhì)可能有不同顏色區(qū)分標簽不遮擋歌名音質(zhì)標簽展示正常不遮擋歌名通過MT-15播放全部按鈕樣式觀察播放全部按鈕的默認狀態(tài)和懸停狀態(tài)按鈕文字/圖標清晰懸停時有顏色或背景變化反饋按鈕清晰懸停有反饋通過MT-16添加本地歌曲交互點擊底部按鈕在文件選擇對話框中選擇音樂文件確認后觀察反饋彈出系統(tǒng)文件選擇對話框選擇文件確認后歌曲出現(xiàn)在本地下載列表中可能伴有添加成功提示文件選擇對話框正常彈出添加后歌曲出現(xiàn)在列表通過MT-17空列表占位提示清空本地下載列表或首次進入無歌曲時觀察頁面展示展示空列表占位圖和提示文字可能伴有添加本地音樂引導(dǎo)按鈕引導(dǎo)用戶添加歌曲展示占位圖和提示文字有引導(dǎo)按鈕通過【MT-09~MT-17 截圖位置】3.4 我喜歡頁面視覺與交互編號測試項目測試步驟預(yù)期結(jié)果實際結(jié)果結(jié)論MT-18頁面標題樣式進入我喜歡頁觀察頁面標題頁面標題我喜歡清晰展示字體大小/顏色與頁面風格一致標題展示正常通過MT-19收藏歌曲列表展示收藏多首歌曲后進入我喜歡頁觀察列表收藏的歌曲按收藏時間或指定順序展示列表項包含歌名、歌手、紅心等信息收藏歌曲正常展示信息完整通過MT-20取消收藏紅心狀態(tài)在我喜歡頁點擊某首歌的紅心取消收藏觀察紅心變化點擊后紅心從實心紅色變?yōu)榭招幕疑珷顟B(tài)即時反饋紅心狀態(tài)切換正常通過MT-21我喜歡頁空列表占位取消所有收藏后觀察我喜歡頁展示空列表占位圖和提示文字引導(dǎo)用戶收藏歌曲展示占位圖和提示文字通過【MT-18~MT-21 截圖位置】3.5 底部播放控制欄交互細節(jié)編號測試項目測試步驟預(yù)期結(jié)果實際結(jié)果結(jié)論MT-22播放/暫停圖標切換播放狀態(tài)下觀察按鈕圖標點擊暫停后再觀察播放狀態(tài)顯示暫停圖標兩條豎線暫停狀態(tài)顯示播放圖標三角形圖標隨狀態(tài)即時切換圖標隨狀態(tài)正確切換通過MT-23上一曲/下一曲懸停效果鼠標懸停在上一曲/下一曲按鈕上按鈕有顏色或背景變化給出可點擊的視覺反饋懸停有視覺反饋通過MT-24播放模式圖標切換連續(xù)點擊播放模式按鈕觀察圖標變化依次切換順序播放→單曲循環(huán)→隨機播放三種模式每種模式對應(yīng)不同圖標圖標切換清晰可辨三種模式圖標切換正常通過MT-25進度條懸停時間提示鼠標懸停在播放進度條上不點擊懸停位置顯示時間提示氣泡展示該位置對應(yīng)的播放時間懸停顯示時間氣泡通過MT-26進度條拖拽手感按住進度條滑塊拖拽到不同位置松開拖拽時滑塊跟隨鼠標移動可能伴有時間預(yù)覽松開后播放位置跳轉(zhuǎn)到對應(yīng)時間播放繼續(xù)拖拽流暢跳轉(zhuǎn)準確通過MT-27音量面板展開/收起點擊音量按鈕觀察音量面板再次點擊或點擊其他區(qū)域點擊后音量面板平滑展開展示音量滑塊和靜音按鈕再次點擊或點擊外部后面板收起面板展開/收起正常通過MT-28音量滑塊拖拽拖拽音量滑塊調(diào)整音量大小滑塊跟隨鼠標移動音量隨滑塊位置實時變化可能伴有音量百分比提示音量調(diào)節(jié)正常通過MT-29靜音按鈕圖標切換點擊靜音按鈕觀察圖標變化靜音狀態(tài)顯示靜音圖標喇叭帶叉取消靜音后恢復(fù)正常喇叭圖標靜音圖標切換正常通過MT-30歌曲封面圖展示播放歌曲時觀察底部播放欄左側(cè)的封面圖展示當前播放歌曲的專輯封面圖圖片清晰無拉伸變形封面圖展示正常通過MT-31歌曲名過長省略處理播放歌名較長的歌曲觀察底部播放欄歌名展示歌名超出顯示區(qū)域時以省略號…結(jié)尾不溢出到其他控件區(qū)域鼠標懸?？赡茱@示完整歌名長歌名以省略號結(jié)尾不溢出通過MT-32播放時間格式觀察底部播放欄的時間顯示以當前時間/總時長格式展示如01:23/04:56時間格式統(tǒng)一進度條位置與時間同步時間格式正確與進度同步通過【MT-22~MT-32 截圖位置】3.6 異常與邊界場景編號測試項目測試步驟預(yù)期結(jié)果實際結(jié)果結(jié)論MT-33快速連續(xù)點擊播放/暫停在1秒內(nèi)快速連續(xù)點擊播放/暫停按鈕5次以上客戶端不崩潰最終狀態(tài)與最后一次點擊一致播放狀態(tài)正確響應(yīng)快速點擊無崩潰狀態(tài)響應(yīng)正確通過MT-34快速連續(xù)點擊下一曲在1秒內(nèi)快速連續(xù)點擊下一曲按鈕10次以上客戶端不崩潰歌曲快速切換最終播放最后一次切換后的歌曲無卡頓或閃退快速切換無崩潰最終歌曲正確通過MT-35播放中關(guān)閉客戶端歌曲播放狀態(tài)下直接點擊窗口關(guān)閉按鈕客戶端正常關(guān)閉進程退出無殘留進程無報錯彈窗關(guān)閉正常無殘留進程通過MT-36無歌曲時點擊播放全部本地下載列表為空時點擊播放全部按鈕無歌曲時播放全部按鈕可能禁用或點擊后無異常報錯不崩潰無歌曲時操作無異常通過MT-37無歌曲時雙擊列表區(qū)域本地下載列表為空時雙擊列表空白區(qū)域無異常報錯不崩潰可能無任何響應(yīng)或提示暫無歌曲雙擊無異常通過MT-38搜索框輸入特殊字符在搜索框中輸入特殊字符!#$%^*()和超長文本100字以上輸入正常無崩潰特殊字符正常顯示超長文本可能以省略號顯示或橫向滾動特殊字符和長文本輸入正常通過【MT-33~MT-38 截圖位置】3.7 主觀體驗評估編號評估項目評估內(nèi)容評估結(jié)果MT-39啟動速度從雙擊快捷方式到主窗口可操作的主觀感受啟動速度較快約3-5秒可操作MT-40頁面切換流暢度導(dǎo)航切換、頁面加載的流暢度主觀感受切換流暢無明顯卡頓MT-41播放操作響應(yīng)點擊播放/暫停/切歌后響應(yīng)速度主觀感受操作響應(yīng)即時無明顯延遲MT-42整體UI美觀度客戶端整體視覺設(shè)計、配色、排版的主觀評價UI設(shè)計現(xiàn)代配色協(xié)調(diào)排版清晰【MT-39~MT-42 為主觀評估無需截圖】四、兼容性測試測試項測試內(nèi)容測試結(jié)果操作系統(tǒng)兼容性Windows 10、Windows 11 下客戶端啟動、功能運行正常通過窗口分辨率適配1024x768、1280x720、1600x900、1920x1080 等常見分辨率下界面布局正常通過窗口大小自適應(yīng)拖拽窗口邊緣調(diào)整大小控件自適應(yīng)排列無重疊越界通過五、自動化測試5.1 自動化測試框架設(shè)計本次自動化測試采用Python pywinauto pytest技術(shù)?；赑OMPage Object Model三層架構(gòu)設(shè)計框架結(jié)構(gòu)如下QQMusic-AutoTest/ ├── config/ │ └── config.yaml # 配置文件程序路徑、超時、測試數(shù)據(jù) ├── pageobjects/ # 頁面對象層POM │ ├── base_page.py # 頁面基類 │ ├── main_page.py # 主頁/導(dǎo)航頁面對象 │ ├── player_page.py # 底部播放控制欄頁面對象 │ ├── search_page.py # 搜索框頁面對象 │ ├── local_page.py # 本地下載頁面對象 │ └── like_page.py # 我喜歡頁面對象 ├── tests/ # 測試用例層 │ ├── test_common.py # 冒煙測試 │ ├── test_navigation.py # 導(dǎo)航測試 │ ├── test_player.py # 播放器測試 │ ├── test_search.py # 搜索框測試 │ ├── test_local_page.py # 本地下載頁測試 │ ├── test_like_page.py # 我喜歡頁測試 │ ├── test_window.py # 窗口操作測試 │ ├── test_ui_layout.py # UI布局測試 │ └── test_performance.py # 性能測試 ├── Utils/ # 工具層 │ ├── commonUtils.py # 通用操作點擊、輸入、等待、截圖 │ ├── configUtils.py # 配置文件讀取 │ └── logUtils.py # 日志封裝 ├── conftest.py # pytest fixtures 失敗自動截圖 ├── pytest.ini # pytest配置 ├── run.py # 測試運行入口 └── requirements.txt # 依賴清單5.1.1 POM三層架構(gòu)設(shè)計思路頁面對象層pageobjects將每個頁面的元素定位和操作方法封裝為獨立的頁面對象類測試用例不直接操作控件而是調(diào)用頁面對象的方法。當頁面元素發(fā)生變化時只需修改對應(yīng)頁面對象無需修改測試用例提高了代碼的可維護性。測試用例層tests只關(guān)心業(yè)務(wù)邏輯和斷言通過調(diào)用頁面對象的方法完成測試步驟。每個測試用例獨立、清晰關(guān)注測什么而非怎么測。工具層Utils封裝通用的底層操作如元素點擊、文本輸入、顯式等待、截圖、日志、配置讀取等供頁面對象層調(diào)用避免重復(fù)代碼。5.1.2 自繪控件處理方案QQ音樂桌面客戶端基于Qt框架開發(fā)部分控件如歌曲列表、紅心收藏按鈕為自繪虛擬化控件UIA無法暴露子元素文本和狀態(tài)。針對這一問題采用以下處理方案列表項操作通過坐標雙擊實現(xiàn)。先獲取列表控件的rectangle區(qū)域計算第一首歌的中心坐標列表left width/2列表top 30使用pywinauto的mouse.double_click()模擬雙擊。紅心收藏按鈕通過坐標點擊實現(xiàn)。紅心位置在歌曲行左側(cè)列表left 20列表top 30 行號*35使用mouse.click()模擬點擊。歌曲信息校驗由于無法直接獲取列表項文本通過底部播放器的歌名/歌手文本間接驗證。雙擊播放后讀取播放器顯示的歌曲名判斷播放是否成功。列表非空判斷自繪列表無法獲取子元素數(shù)量通過列表區(qū)域的可見性rectangle寬高是否合理和雙擊后播放器是否有歌曲信息來間接判斷列表是否有內(nèi)容。5.1.3 測試穩(wěn)定性保障自動聚焦窗口每個測試用例執(zhí)行前通過autouse fixture自動聚焦QQ音樂窗口確保鼠標操作在前臺窗口執(zhí)行。顯式等待所有元素操作前調(diào)用wait(“exists visible”)等待元素出現(xiàn)并可見避免因頁面加載延遲導(dǎo)致的操作失敗。點擊回退機制優(yōu)先使用UIA的click()發(fā)送InvokePattern對于Text等不支持click()的控件回退到click_input()模擬鼠標點擊。鼠標操作重試針對Windows SetCursorPos偶發(fā)錯誤對click_input()和坐標雙擊操作增加5次重試每次間隔1秒提高測試穩(wěn)定性。失敗自動截圖通過pytest_runtest_makereport鉤子在用例失敗時自動截圖并嵌入HTML報告便于問題定位。5.2 自動化測試用例清單本次自動化測試共實現(xiàn)46個測試用例全部通過測試文件測試類用例數(shù)用例列表test_common.pyTestCommon3test_app_launch、test_screenshot、test_window_titletest_navigation.pyTestNavigation5test_main_page_loaded、test_left_navigation、test_back_to_recommend、test_nav_my_music_items、test_nav_song_not_interruptedtest_player.pyTestPlayer10test_play_pause、test_next_prev_song、test_playing_status、test_volume_button、test_play_mode、test_playback_info_display、test_volume_adjust、test_progress_bar_seek 、test_play_mode_effect、test_play_mode_sequence_vs_randomtest_search.pyTestSearchBox4test_search_box_exists、test_search_box_input、test_search_box_focus、test_search_box_persist_after_navtest_local_page.pyTestLocalPage7test_local_page_title、test_local_list_headers、test_local_list_has_songs、test_add_local_song、test_local_first_song_info、test_local_double_click_play、test_local_play_alltest_like_page.pyTestLikePage8test_like_page_load、test_like_list_display、test_add_to_like、test_like_page_play、test_like_play_all、test_cancel_like、test_like_multiple_songs、test_like_song_info_matchtest_window.pyTestWindow2test_window_maximize_restore、test_window_minimize_restoretest_ui_layout.pyTestUILayout4test_window_resize_no_overlap、test_selected_song_highlight、test_icons_and_quality_labels、test_player_controls_responsivetest_performance.pyTestPerformance3test_high_frequency_switch_song、test_page_load_time、test_memory_leak_during_playback合計465.3 性能測試實現(xiàn)方案性能測試使用psutil庫監(jiān)控QQ音樂進程的CPU和內(nèi)存占用實現(xiàn)方案如下5.3.1 高頻切歌性能測試測試步驟導(dǎo)航到本地下載頁雙擊播放第一首歌連續(xù)點擊下一曲按鈕20次每5次采樣一次CPU和內(nèi)存。監(jiān)控指標平均CPU、峰值CPU、內(nèi)存增長量、切歌成功率。通過標準平均CPU≤80%峰值CPU≤90%內(nèi)存增長≤100MB切歌成功率≥90%進程不崩潰。5.3.2 頁面加載耗時測試測試步驟從推薦頁導(dǎo)航到本地下載頁測量從點擊導(dǎo)航到列表元素出現(xiàn)的耗時重復(fù)5次取平均值。監(jiān)控指標平均加載耗時、最大加載耗時、最小加載耗時。通過標準平均加載耗時≤5000ms。5.3.3 內(nèi)存泄漏測試測試步驟導(dǎo)航到本地下載頁播放歌曲持續(xù)播放2分鐘每10秒采樣一次內(nèi)存計算前半段和后半段的平均內(nèi)存增長率。監(jiān)控指標前半段平均內(nèi)存、后半段平均內(nèi)存、內(nèi)存增長率、最終內(nèi)存。通過標準內(nèi)存增長率≤10%最終內(nèi)存≤初始內(nèi)存的150%進程不崩潰。5.4 自動化測試運行結(jié)果collected 46 items tests/test_common.py::TestCommon::test_app_launch PASSED tests/test_common.py::TestCommon::test_screenshot PASSED tests/test_common.py::TestCommon::test_window_title PASSED tests/test_navigation.py::TestNavigation::test_main_page_loaded PASSED ...中間省略 tests/test_performance.py::TestPerformance::test_high_frequency_switch_song PASSED tests/test_performance.py::TestPerformance::test_page_load_time PASSED tests/test_performance.py::TestPerformance::test_memory_leak_during_playback PASSED 46 passed in 865.37s (0:14:25) 測試結(jié)果46個自動化測試用例全部通過通過率100%總耗時約14分25秒。六、發(fā)現(xiàn)的BUG在本次測試過程中發(fā)現(xiàn)以下問題6.1 搜索功能異常問題描述QQ音樂桌面客戶端頂部搜索框輸入關(guān)鍵詞后按回車搜索結(jié)果頁面無法正常加載搜索功能不可用。影響范圍搜索功能完全不可用用戶無法通過搜索查找歌曲、歌手、專輯等內(nèi)容。嚴重程度高處理方式由于搜索功能本身存在異常自動化測試僅覆蓋搜索框的UI層面測試存在性、輸入、焦點、持久化不驗證搜索結(jié)果。該問題需開發(fā)團隊進一步排查。6.2 窗口放大時頁面元素未同步放大問題描述將QQ音樂窗口從默認大小拖拽放大到全屏1920x1080時窗口邊框擴大但頁面內(nèi)部的歌曲列表、封面圖、歌詞區(qū)域等核心內(nèi)容元素沒有隨窗口等比例放大元素仍保持原尺寸導(dǎo)致大窗口下頁面兩側(cè)出現(xiàn)大量空白區(qū)域內(nèi)容集中在窗口中間視覺效果不協(xié)調(diào)。復(fù)現(xiàn)步驟啟動QQ音樂窗口保持默認大小拖拽窗口右下角將窗口放大到接近全屏觀察頁面內(nèi)容區(qū)域預(yù)期結(jié)果頁面內(nèi)容元素隨窗口大小等比例放大或自適應(yīng)填充充分利用窗口空間。實際結(jié)果頁面元素尺寸不變大窗口下兩側(cè)留白過多內(nèi)容未自適應(yīng)填充。影響范圍大屏用戶體驗不佳窗口空間未充分利用。嚴重程度中6.3 小窗口下控件重疊問題描述將窗口縮小到800x600及以下尺寸時底部播放控制欄的播放/暫停、上一曲、下一曲、音量、播放模式等按鈕出現(xiàn)重疊部分按鈕被遮擋無法正常點擊。復(fù)現(xiàn)步驟啟動QQ音樂拖拽窗口邊緣將窗口縮小到800x600觀察底部播放控制欄預(yù)期結(jié)果窗口縮小時控件自適應(yīng)排列不重疊、不越界核心按鈕可正常點擊。實際結(jié)果底部播放欄按鈕重疊部分按鈕被遮擋無法點擊。影響范圍小窗口或低分辨率屏幕用戶無法正常操作播放控制欄。嚴重程度中6.4 取消收藏后列表不立即刷新問題描述在我喜歡頁面點擊紅心取消收藏某首歌曲后該歌曲仍保留在當前列表展示中不會立即從列表中移除。需要切換到其他導(dǎo)航頁面再重新進入我喜歡頁面列表才會刷新取消收藏的歌曲才會消失。復(fù)現(xiàn)步驟進入我喜歡頁面確保列表中有收藏的歌曲點擊第一首歌左側(cè)的紅心取消收藏觀察當前列表預(yù)期結(jié)果取消收藏后該歌曲立即從當前列表中移除列表實時刷新。實際結(jié)果取消收藏后歌曲仍在列表中需切換頁面再返回才會刷新。影響范圍用戶取消收藏后無法即時看到效果可能誤以為取消收藏失敗而重復(fù)操作。嚴重程度低6.5 自繪控件可訪問性限制問題描述QQ音樂本地下載列表和我喜歡列表基于Qt框架自繪渲染UIAUI Automation無法暴露列表項的文本內(nèi)容和子元素結(jié)構(gòu)導(dǎo)致自動化測試無法直接獲取歌曲名、歌手名等信息也無法直接定位紅心收藏按鈕的狀態(tài)。影響范圍自動化測試對列表項的操作只能通過坐標點擊實現(xiàn)穩(wěn)定性和可維護性低于標準控件收藏按鈕的狀態(tài)已收藏/未收藏無法通過UIA斷言需人工確認同時也影響屏幕閱讀器等無障礙工具的使用。嚴重程度低產(chǎn)品層面為可訪問性問題測試層面為技術(shù)限制處理方式采用坐標點擊播放器文本間接驗證的方案覆蓋核心功能視覺類驗證高亮樣式、圖標渲染采用截圖保存人工確認的方式。建議開發(fā)團隊在自繪控件中實現(xiàn)UIA Provider提升無障礙訪問能力。七、測試總結(jié)以及建議7.1 測試總結(jié)本次QQ音樂桌面客戶端測試覆蓋功能測試、UI布局測試、性能測試三大維度共設(shè)計并執(zhí)行了46個自動化測試用例和若干手工測試用例測試結(jié)果如下功能測試客戶端啟動、導(dǎo)航切換、本地下載管理、我喜歡收藏、底部播放控制、窗口操作等核心功能均正常運行功能完整性和正確性達標。UI布局測試客戶端在不同窗口大小下控件自適應(yīng)排列無重疊、無越界選中高亮、收藏圖標、音質(zhì)標簽等視覺元素正常渲染。性能測試高頻切歌場景下CPU和內(nèi)存占用在合理范圍內(nèi)無崩潰頁面加載耗時達標長時間持續(xù)播放無明顯內(nèi)存泄漏。自動化測試46個自動化測試用例全部通過通過率100%自動化回歸測試體系搭建完成。7.2 優(yōu)化建議修復(fù)搜索功能搜索功能是音樂客戶端的核心入口當前搜索功能異常嚴重影響用戶體驗建議開發(fā)團隊優(yōu)先排查修復(fù)。提升控件可訪問性建議開發(fā)團隊在自繪控件中實現(xiàn)UIA Provider暴露列表項文本和子元素結(jié)構(gòu)提升無障礙訪問能力和自動化測試可維護性。增加異常場景測試建議補充網(wǎng)絡(luò)斷開、音頻文件損壞、文件移動/刪除后播放等異常場景的測試提升客戶端容錯能力。多系統(tǒng)兼容性測試建議在更多Windows版本W(wǎng)in7/Win8/Win10/Win11和不同分辨率下進行兼容性測試確保全平臺體驗一致。7.3 后續(xù)測試重點搜索功能修復(fù)后回歸測試搜索功能修復(fù)后需補充搜索結(jié)果展示、搜索結(jié)果分類切換、無結(jié)果提示等搜索相關(guān)的自動化測試用例。歌單管理功能測試當前測試未覆蓋歌單創(chuàng)建、歌單編輯、歌單分享等歌單管理功能后續(xù)需補充。會員功能測試會員專屬音質(zhì)、會員專屬曲庫、會員彈窗等會員相關(guān)功能需補充測試。長時間穩(wěn)定性測試建議執(zhí)行24小時以上的長時間穩(wěn)定性測試驗證客戶端在超長運行時間下的內(nèi)存泄漏和崩潰情況。自動化測試持續(xù)集成將自動化測試接入CI/CD流水線實現(xiàn)每次代碼提交后自動回歸測試提升測試效率。附錄附錄A自動化測試環(huán)境搭建安裝Python 3.9及以上版本克隆項目到本地項目代碼shturl.cc/GrRCImEPeijhCSDZq8TH4jSeyJmqiOGkwzxXz5GoeD3qDlM創(chuàng)建虛擬環(huán)境python -m venv .venv激活虛擬環(huán)境.venv\Scripts\activate安裝依賴pip install -r requirements.txt修改config/config.yaml中的QQ音樂路徑和測試音樂目錄運行測試python run.py附錄B測試運行命令# 運行全部測試python run.py# 按模塊運行python run.py smoke# 冒煙測試python run.py navigation# 導(dǎo)航測試python run.py player# 播放器測試python run.pylocal# 本地下載頁python run.py like# 我喜歡頁python run.py ui# UI布局測試python run.py performance# 性能測試python run.py core# 核心功能# 查看報告# HTML報告直接用瀏覽器打開 reports/report.html# Allure報告allure serve reports/allure-results附錄C性能測試閾值配置指標閾值說明高頻切歌平均CPU≤80%20次連續(xù)切歌場景高頻切歌峰值CPU≤90%允許短暫峰值高頻切歌內(nèi)存增長≤100MB切歌前后內(nèi)存差值切歌成功率≥90%20次切歌成功比例頁面加載平均耗時≤5000ms導(dǎo)航到本地下載頁長時間播放內(nèi)存增長率≤10%前后半段平均內(nèi)存對比最終內(nèi)存/初始內(nèi)存≤150%2分鐘播放后內(nèi)存比值 仿QQ音樂桌面客戶端——測試報告
仿QQ音樂桌面客戶端——測試報告一、項目介紹1.1 項目背景QQ音樂是騰訊公司推出的一款網(wǎng)絡(luò)音樂服務(wù)產(chǎn)品提供海量音樂在線試聽、新歌熱歌首發(fā)、歌詞翻譯、手機鈴聲下載、高品質(zhì)無損音樂試聽、正版音樂下載、免費空間背景音樂設(shè)置、MV觀看等功能。桌面客戶端作為QQ音樂的重要終端承載了用戶日常聽歌、管理本地音樂、收藏歌單等核心場景。隨著QQ音樂桌面客戶端功能的不斷迭代客戶端的穩(wěn)定性、功能完整性和用戶體驗直接影響著億萬用戶的使用感受。為確保客戶端在發(fā)布前各項功能正常運行、界面布局合理、性能表現(xiàn)達標我們開展了本次全面的測試工作。本次測試以QQ音樂Windows桌面客戶端為測試對象覆蓋功能測試、UI布局測試、性能測試三大維度通過手工測試與自動化測試相結(jié)合的方式系統(tǒng)性地保障客戶端質(zhì)量。1.2 測試目的本次測試圍繞以下核心目標展開1.2.1 功能正確性與完整性驗證QQ音樂桌面客戶端的核心功能模塊是否正常運行包括客戶端啟動、左側(cè)導(dǎo)航切換、本地下載管理、我喜歡收藏、底部播放控制、窗口操作等。確保各功能模塊的業(yè)務(wù)邏輯正確模塊間銜接無斷點符合用戶實際使用習慣。1.2.2 用戶體驗與界面一致性驗證客戶端界面布局是否合理控件在不同窗口大小下是否自適應(yīng)排列有無重疊、越界、文字截斷等問題。驗證選中高亮、收藏圖標、音質(zhì)標簽等視覺元素是否正常渲染確保用戶體驗流暢一致。1.2.3 性能與穩(wěn)定性驗證客戶端在高頻操作場景下的性能表現(xiàn)包括高頻切歌時的CPU和內(nèi)存占用、大量本地歌曲加載耗時、長時間持續(xù)播放時的內(nèi)存泄漏情況。確保客戶端在長時間運行和高頻操作下保持穩(wěn)定無崩潰、無明顯性能衰減。1.2.4 自動化測試體系建設(shè)搭建基于Python pywinauto的桌面端UI自動化測試框架采用POMPage Object Model三層架構(gòu)實現(xiàn)核心功能的自動化回歸測試提高測試效率降低人工回歸成本。1.3 測試環(huán)境項目配置操作系統(tǒng)Windows 10 / Windows 11測試對象QQ音樂 Windows桌面客戶端自動化語言Python 3.9GUI自動化框架pywinauto 0.6.8UIA backend測試框架pytest 8.3.2性能監(jiān)控psutil 5.9.0測試報告Allure 2.13.5 pytest-html 4.2.0控件探查工具UIspy / inspect.exe二、設(shè)計測試用例測試用例設(shè)計錨定需求分析結(jié)合等價類劃分與邊界值分析再通過場景測試模擬用戶實際操作。本次測試用例分為三大類功能測試、UI布局測試、性能測試。2.1 功能測試用例功能測試覆蓋客戶端的核心功能模塊共設(shè)計9個模塊、37個測試用例測試模塊用例數(shù)測試內(nèi)容冒煙測試3應(yīng)用啟動、截圖功能、窗口標題校驗導(dǎo)航測試5主頁加載、左側(cè)導(dǎo)航切換、返回推薦、導(dǎo)航不中斷播放、我的音樂導(dǎo)航播放器測試8播放暫停、上下曲切換、播放狀態(tài)、進度條拖拽、音量按鈕、音量調(diào)節(jié)、播放模式切換、播放信息展示搜索框測試4搜索框存在性、輸入功能、焦點獲取、導(dǎo)航后持久化本地下載頁7頁面加載、列表表頭、列表有歌曲、添加本地歌曲、歌曲信息、雙擊播放、播放全部我喜歡頁8頁面加載、列表展示、收藏歌曲、雙擊播放、播放全部、取消收藏、收藏多首、收藏信息校驗窗口操作2最大化還原、最小化還原2.2 UI布局測試用例UI布局測試驗證客戶端界面在不同窗口大小下的自適應(yīng)表現(xiàn)共設(shè)計4個測試用例用例名稱測試內(nèi)容窗口縮放控件無重疊縮放窗口到1024x768、1280x720、1600x900驗證底部播放欄控件無重疊、無越界選中歌曲高亮樣式點擊列表歌曲驗證選中狀態(tài)截圖保存供人工確認高亮樣式收藏圖標與音質(zhì)標簽渲染驗證本地下載列表中收藏圖標紅心、音質(zhì)標簽SQ/HQ正常渲染播放控件自適應(yīng)布局拉伸窗口寬度到1000/1200/1400/1800驗證播放控件保持水平排列、間距合理2.3 性能測試用例性能測試驗證客戶端在高頻操作和長時間運行下的性能表現(xiàn)共設(shè)計3個測試用例用例名稱測試內(nèi)容性能指標高頻切歌CPU/內(nèi)存監(jiān)控連續(xù)切歌20次每5次采樣一次CPU和內(nèi)存平均CPU≤80%峰值CPU≤90%內(nèi)存增長≤100MB頁面加載耗時統(tǒng)計從推薦頁導(dǎo)航到本地下載頁測量列表元素出現(xiàn)耗時重復(fù)5次取平均平均加載耗時≤5000ms長時間播放內(nèi)存泄漏持續(xù)播放2分鐘每10秒采樣一次內(nèi)存前后半段內(nèi)存增長率對比內(nèi)存增長率≤10%最終內(nèi)存≤初始內(nèi)存150%三、手動測試自動化測試已覆蓋客戶端啟動、導(dǎo)航切換、播放控制、本地下載、我喜歡、窗口操作、UI布局、性能等46個可量化的功能點。手動測試聚焦于自動化無法覆蓋的視覺細節(jié)、交互體驗、異常邊界場景與自動化測試形成互補不重復(fù)覆蓋。3.1 客戶端啟動與窗口視覺編號測試項目測試步驟預(yù)期結(jié)果實際結(jié)果結(jié)論MT-01啟動加載過程雙擊QQ音樂快捷方式觀察從啟動到主窗口完全加載的過程啟動后無閃退、無白屏主窗口在合理時間內(nèi)加載完成左側(cè)導(dǎo)航、中間內(nèi)容區(qū)、底部播放欄三欄布局完整啟動正常三欄布局完整展示通過MT-02主窗口視覺布局觀察主窗口整體布局比例左側(cè)導(dǎo)航欄寬度適中中間內(nèi)容區(qū)占據(jù)主要空間底部播放欄高度合理三欄比例協(xié)調(diào)無內(nèi)容溢出或大面積空白三欄比例協(xié)調(diào)布局正常通過MT-03窗口拖拽移動按住窗口標題欄拖拽移動窗口窗口跟隨鼠標平滑移動移動過程中無卡頓、無殘影窗口拖拽平滑無卡頓通過MT-04窗口邊緣拖拽調(diào)整大小拖拽窗口右邊緣調(diào)整寬度拖拽下邊緣調(diào)整高度拖拽過程中顯示窗口大小預(yù)覽松開后窗口尺寸更新內(nèi)容區(qū)自適應(yīng)調(diào)整窗口大小調(diào)整正常內(nèi)容區(qū)自適應(yīng)通過【MT-01——MT-04客戶端啟動與窗口視覺】3.2 左側(cè)導(dǎo)航欄交互體驗編號測試項目測試步驟預(yù)期結(jié)果實際結(jié)果結(jié)論MT-05導(dǎo)航項懸停效果鼠標懸停在左側(cè)導(dǎo)航項推薦/排行榜/歌手等上不點擊懸停項背景色或文字顏色發(fā)生變化給出視覺反饋懸停時有顏色變化反饋通過MT-06導(dǎo)航項選中狀態(tài)點擊某個導(dǎo)航項觀察選中樣式選中項高亮顯示背景色/文字顏色與未選中項有明顯區(qū)別可能伴有左側(cè)指示條選中項高亮明顯有指示條通過MT-07導(dǎo)航切換過渡連續(xù)點擊不同導(dǎo)航項觀察頁面切換過程頁面切換流暢無明顯卡頓或白屏閃爍切換后新頁面內(nèi)容加載完整切換流暢內(nèi)容加載正常通過MT-08導(dǎo)航圖標與文字對齊觀察左側(cè)導(dǎo)航項的圖標與文字排版圖標與文字水平居中對齊間距均勻無錯位圖標文字對齊正常通過【MT-05~MT-08 截圖位置左側(cè)導(dǎo)航欄交互體驗】3.3 本地下載頁面視覺與交互編號測試項目測試步驟預(yù)期結(jié)果實際結(jié)果結(jié)論MT-09列表表頭樣式進表頭展示歌名、歌手、專輯、音質(zhì)等列名列寬分配合理文字對齊統(tǒng)一表頭列名完整列寬合理通過MT-10歌曲行懸停效果鼠標懸停在某首歌曲行上不點擊懸停行背景色發(fā)生變化與其他行區(qū)分開懸停行背景色變化通過MT-11歌曲行選中效果單擊某首歌曲行觀察選中樣式選中行高亮顯示背景色明顯區(qū)別于未選中行選中行高亮明顯通過MT-12紅心收藏圖標狀態(tài)觀察未收藏歌曲和已收藏歌曲的紅心圖標未收藏時紅心為空心/灰色已收藏時紅心為實心/紅色兩種狀態(tài)視覺區(qū)分明顯未收藏灰色已收藏紅色區(qū)分明顯通過MT-13紅心懸停效果鼠標懸停在紅心圖標上紅心圖標有視覺反饋顏色加深或放大提示可點擊懸停時有視覺反饋通過MT-14音質(zhì)標簽樣式觀察歌曲行中的音質(zhì)標簽SQ/HQ/無損等音質(zhì)標簽以小標簽形式展示在歌名旁不同音質(zhì)可能有不同顏色區(qū)分標簽不遮擋歌名音質(zhì)標簽展示正常不遮擋歌名通過MT-15播放全部按鈕樣式觀察播放全部按鈕的默認狀態(tài)和懸停狀態(tài)按鈕文字/圖標清晰懸停時有顏色或背景變化反饋按鈕清晰懸停有反饋通過MT-16添加本地歌曲交互點擊底部按鈕在文件選擇對話框中選擇音樂文件確認后觀察反饋彈出系統(tǒng)文件選擇對話框選擇文件確認后歌曲出現(xiàn)在本地下載列表中可能伴有添加成功提示文件選擇對話框正常彈出添加后歌曲出現(xiàn)在列表通過MT-17空列表占位提示清空本地下載列表或首次進入無歌曲時觀察頁面展示展示空列表占位圖和提示文字可能伴有添加本地音樂引導(dǎo)按鈕引導(dǎo)用戶添加歌曲展示占位圖和提示文字有引導(dǎo)按鈕通過【MT-09~MT-17 截圖位置】3.4 我喜歡頁面視覺與交互編號測試項目測試步驟預(yù)期結(jié)果實際結(jié)果結(jié)論MT-18頁面標題樣式進入我喜歡頁觀察頁面標題頁面標題我喜歡清晰展示字體大小/顏色與頁面風格一致標題展示正常通過MT-19收藏歌曲列表展示收藏多首歌曲后進入我喜歡頁觀察列表收藏的歌曲按收藏時間或指定順序展示列表項包含歌名、歌手、紅心等信息收藏歌曲正常展示信息完整通過MT-20取消收藏紅心狀態(tài)在我喜歡頁點擊某首歌的紅心取消收藏觀察紅心變化點擊后紅心從實心紅色變?yōu)榭招幕疑珷顟B(tài)即時反饋紅心狀態(tài)切換正常通過MT-21我喜歡頁空列表占位取消所有收藏后觀察我喜歡頁展示空列表占位圖和提示文字引導(dǎo)用戶收藏歌曲展示占位圖和提示文字通過【MT-18~MT-21 截圖位置】3.5 底部播放控制欄交互細節(jié)編號測試項目測試步驟預(yù)期結(jié)果實際結(jié)果結(jié)論MT-22播放/暫停圖標切換播放狀態(tài)下觀察按鈕圖標點擊暫停后再觀察播放狀態(tài)顯示暫停圖標兩條豎線暫停狀態(tài)顯示播放圖標三角形圖標隨狀態(tài)即時切換圖標隨狀態(tài)正確切換通過MT-23上一曲/下一曲懸停效果鼠標懸停在上一曲/下一曲按鈕上按鈕有顏色或背景變化給出可點擊的視覺反饋懸停有視覺反饋通過MT-24播放模式圖標切換連續(xù)點擊播放模式按鈕觀察圖標變化依次切換順序播放→單曲循環(huán)→隨機播放三種模式每種模式對應(yīng)不同圖標圖標切換清晰可辨三種模式圖標切換正常通過MT-25進度條懸停時間提示鼠標懸停在播放進度條上不點擊懸停位置顯示時間提示氣泡展示該位置對應(yīng)的播放時間懸停顯示時間氣泡通過MT-26進度條拖拽手感按住進度條滑塊拖拽到不同位置松開拖拽時滑塊跟隨鼠標移動可能伴有時間預(yù)覽松開后播放位置跳轉(zhuǎn)到對應(yīng)時間播放繼續(xù)拖拽流暢跳轉(zhuǎn)準確通過MT-27音量面板展開/收起點擊音量按鈕觀察音量面板再次點擊或點擊其他區(qū)域點擊后音量面板平滑展開展示音量滑塊和靜音按鈕再次點擊或點擊外部后面板收起面板展開/收起正常通過MT-28音量滑塊拖拽拖拽音量滑塊調(diào)整音量大小滑塊跟隨鼠標移動音量隨滑塊位置實時變化可能伴有音量百分比提示音量調(diào)節(jié)正常通過MT-29靜音按鈕圖標切換點擊靜音按鈕觀察圖標變化靜音狀態(tài)顯示靜音圖標喇叭帶叉取消靜音后恢復(fù)正常喇叭圖標靜音圖標切換正常通過MT-30歌曲封面圖展示播放歌曲時觀察底部播放欄左側(cè)的封面圖展示當前播放歌曲的專輯封面圖圖片清晰無拉伸變形封面圖展示正常通過MT-31歌曲名過長省略處理播放歌名較長的歌曲觀察底部播放欄歌名展示歌名超出顯示區(qū)域時以省略號…結(jié)尾不溢出到其他控件區(qū)域鼠標懸?？赡茱@示完整歌名長歌名以省略號結(jié)尾不溢出通過MT-32播放時間格式觀察底部播放欄的時間顯示以當前時間/總時長格式展示如01:23/04:56時間格式統(tǒng)一進度條位置與時間同步時間格式正確與進度同步通過【MT-22~MT-32 截圖位置】3.6 異常與邊界場景編號測試項目測試步驟預(yù)期結(jié)果實際結(jié)果結(jié)論MT-33快速連續(xù)點擊播放/暫停在1秒內(nèi)快速連續(xù)點擊播放/暫停按鈕5次以上客戶端不崩潰最終狀態(tài)與最后一次點擊一致播放狀態(tài)正確響應(yīng)快速點擊無崩潰狀態(tài)響應(yīng)正確通過MT-34快速連續(xù)點擊下一曲在1秒內(nèi)快速連續(xù)點擊下一曲按鈕10次以上客戶端不崩潰歌曲快速切換最終播放最后一次切換后的歌曲無卡頓或閃退快速切換無崩潰最終歌曲正確通過MT-35播放中關(guān)閉客戶端歌曲播放狀態(tài)下直接點擊窗口關(guān)閉按鈕客戶端正常關(guān)閉進程退出無殘留進程無報錯彈窗關(guān)閉正常無殘留進程通過MT-36無歌曲時點擊播放全部本地下載列表為空時點擊播放全部按鈕無歌曲時播放全部按鈕可能禁用或點擊后無異常報錯不崩潰無歌曲時操作無異常通過MT-37無歌曲時雙擊列表區(qū)域本地下載列表為空時雙擊列表空白區(qū)域無異常報錯不崩潰可能無任何響應(yīng)或提示暫無歌曲雙擊無異常通過MT-38搜索框輸入特殊字符在搜索框中輸入特殊字符!#$%^*()和超長文本100字以上輸入正常無崩潰特殊字符正常顯示超長文本可能以省略號顯示或橫向滾動特殊字符和長文本輸入正常通過【MT-33~MT-38 截圖位置】3.7 主觀體驗評估編號評估項目評估內(nèi)容評估結(jié)果MT-39啟動速度從雙擊快捷方式到主窗口可操作的主觀感受啟動速度較快約3-5秒可操作MT-40頁面切換流暢度導(dǎo)航切換、頁面加載的流暢度主觀感受切換流暢無明顯卡頓MT-41播放操作響應(yīng)點擊播放/暫停/切歌后響應(yīng)速度主觀感受操作響應(yīng)即時無明顯延遲MT-42整體UI美觀度客戶端整體視覺設(shè)計、配色、排版的主觀評價UI設(shè)計現(xiàn)代配色協(xié)調(diào)排版清晰【MT-39~MT-42 為主觀評估無需截圖】四、兼容性測試測試項測試內(nèi)容測試結(jié)果操作系統(tǒng)兼容性Windows 10、Windows 11 下客戶端啟動、功能運行正常通過窗口分辨率適配1024x768、1280x720、1600x900、1920x1080 等常見分辨率下界面布局正常通過窗口大小自適應(yīng)拖拽窗口邊緣調(diào)整大小控件自適應(yīng)排列無重疊越界通過五、自動化測試5.1 自動化測試框架設(shè)計本次自動化測試采用Python pywinauto pytest技術(shù)?；赑OMPage Object Model三層架構(gòu)設(shè)計框架結(jié)構(gòu)如下QQMusic-AutoTest/ ├── config/ │ └── config.yaml # 配置文件程序路徑、超時、測試數(shù)據(jù) ├── pageobjects/ # 頁面對象層POM │ ├── base_page.py # 頁面基類 │ ├── main_page.py # 主頁/導(dǎo)航頁面對象 │ ├── player_page.py # 底部播放控制欄頁面對象 │ ├── search_page.py # 搜索框頁面對象 │ ├── local_page.py # 本地下載頁面對象 │ └── like_page.py # 我喜歡頁面對象 ├── tests/ # 測試用例層 │ ├── test_common.py # 冒煙測試 │ ├── test_navigation.py # 導(dǎo)航測試 │ ├── test_player.py # 播放器測試 │ ├── test_search.py # 搜索框測試 │ ├── test_local_page.py # 本地下載頁測試 │ ├── test_like_page.py # 我喜歡頁測試 │ ├── test_window.py # 窗口操作測試 │ ├── test_ui_layout.py # UI布局測試 │ └── test_performance.py # 性能測試 ├── Utils/ # 工具層 │ ├── commonUtils.py # 通用操作點擊、輸入、等待、截圖 │ ├── configUtils.py # 配置文件讀取 │ └── logUtils.py # 日志封裝 ├── conftest.py # pytest fixtures 失敗自動截圖 ├── pytest.ini # pytest配置 ├── run.py # 測試運行入口 └── requirements.txt # 依賴清單5.1.1 POM三層架構(gòu)設(shè)計思路頁面對象層pageobjects將每個頁面的元素定位和操作方法封裝為獨立的頁面對象類測試用例不直接操作控件而是調(diào)用頁面對象的方法。當頁面元素發(fā)生變化時只需修改對應(yīng)頁面對象無需修改測試用例提高了代碼的可維護性。測試用例層tests只關(guān)心業(yè)務(wù)邏輯和斷言通過調(diào)用頁面對象的方法完成測試步驟。每個測試用例獨立、清晰關(guān)注測什么而非怎么測。工具層Utils封裝通用的底層操作如元素點擊、文本輸入、顯式等待、截圖、日志、配置讀取等供頁面對象層調(diào)用避免重復(fù)代碼。5.1.2 自繪控件處理方案QQ音樂桌面客戶端基于Qt框架開發(fā)部分控件如歌曲列表、紅心收藏按鈕為自繪虛擬化控件UIA無法暴露子元素文本和狀態(tài)。針對這一問題采用以下處理方案列表項操作通過坐標雙擊實現(xiàn)。先獲取列表控件的rectangle區(qū)域計算第一首歌的中心坐標列表left width/2列表top 30使用pywinauto的mouse.double_click()模擬雙擊。紅心收藏按鈕通過坐標點擊實現(xiàn)。紅心位置在歌曲行左側(cè)列表left 20列表top 30 行號*35使用mouse.click()模擬點擊。歌曲信息校驗由于無法直接獲取列表項文本通過底部播放器的歌名/歌手文本間接驗證。雙擊播放后讀取播放器顯示的歌曲名判斷播放是否成功。列表非空判斷自繪列表無法獲取子元素數(shù)量通過列表區(qū)域的可見性rectangle寬高是否合理和雙擊后播放器是否有歌曲信息來間接判斷列表是否有內(nèi)容。5.1.3 測試穩(wěn)定性保障自動聚焦窗口每個測試用例執(zhí)行前通過autouse fixture自動聚焦QQ音樂窗口確保鼠標操作在前臺窗口執(zhí)行。顯式等待所有元素操作前調(diào)用wait(“exists visible”)等待元素出現(xiàn)并可見避免因頁面加載延遲導(dǎo)致的操作失敗。點擊回退機制優(yōu)先使用UIA的click()發(fā)送InvokePattern對于Text等不支持click()的控件回退到click_input()模擬鼠標點擊。鼠標操作重試針對Windows SetCursorPos偶發(fā)錯誤對click_input()和坐標雙擊操作增加5次重試每次間隔1秒提高測試穩(wěn)定性。失敗自動截圖通過pytest_runtest_makereport鉤子在用例失敗時自動截圖并嵌入HTML報告便于問題定位。5.2 自動化測試用例清單本次自動化測試共實現(xiàn)46個測試用例全部通過測試文件測試類用例數(shù)用例列表test_common.pyTestCommon3test_app_launch、test_screenshot、test_window_titletest_navigation.pyTestNavigation5test_main_page_loaded、test_left_navigation、test_back_to_recommend、test_nav_my_music_items、test_nav_song_not_interruptedtest_player.pyTestPlayer10test_play_pause、test_next_prev_song、test_playing_status、test_volume_button、test_play_mode、test_playback_info_display、test_volume_adjust、test_progress_bar_seek 、test_play_mode_effect、test_play_mode_sequence_vs_randomtest_search.pyTestSearchBox4test_search_box_exists、test_search_box_input、test_search_box_focus、test_search_box_persist_after_navtest_local_page.pyTestLocalPage7test_local_page_title、test_local_list_headers、test_local_list_has_songs、test_add_local_song、test_local_first_song_info、test_local_double_click_play、test_local_play_alltest_like_page.pyTestLikePage8test_like_page_load、test_like_list_display、test_add_to_like、test_like_page_play、test_like_play_all、test_cancel_like、test_like_multiple_songs、test_like_song_info_matchtest_window.pyTestWindow2test_window_maximize_restore、test_window_minimize_restoretest_ui_layout.pyTestUILayout4test_window_resize_no_overlap、test_selected_song_highlight、test_icons_and_quality_labels、test_player_controls_responsivetest_performance.pyTestPerformance3test_high_frequency_switch_song、test_page_load_time、test_memory_leak_during_playback合計465.3 性能測試實現(xiàn)方案性能測試使用psutil庫監(jiān)控QQ音樂進程的CPU和內(nèi)存占用實現(xiàn)方案如下5.3.1 高頻切歌性能測試測試步驟導(dǎo)航到本地下載頁雙擊播放第一首歌連續(xù)點擊下一曲按鈕20次每5次采樣一次CPU和內(nèi)存。監(jiān)控指標平均CPU、峰值CPU、內(nèi)存增長量、切歌成功率。通過標準平均CPU≤80%峰值CPU≤90%內(nèi)存增長≤100MB切歌成功率≥90%進程不崩潰。5.3.2 頁面加載耗時測試測試步驟從推薦頁導(dǎo)航到本地下載頁測量從點擊導(dǎo)航到列表元素出現(xiàn)的耗時重復(fù)5次取平均值。監(jiān)控指標平均加載耗時、最大加載耗時、最小加載耗時。通過標準平均加載耗時≤5000ms。5.3.3 內(nèi)存泄漏測試測試步驟導(dǎo)航到本地下載頁播放歌曲持續(xù)播放2分鐘每10秒采樣一次內(nèi)存計算前半段和后半段的平均內(nèi)存增長率。監(jiān)控指標前半段平均內(nèi)存、后半段平均內(nèi)存、內(nèi)存增長率、最終內(nèi)存。通過標準內(nèi)存增長率≤10%最終內(nèi)存≤初始內(nèi)存的150%進程不崩潰。5.4 自動化測試運行結(jié)果collected 46 items tests/test_common.py::TestCommon::test_app_launch PASSED tests/test_common.py::TestCommon::test_screenshot PASSED tests/test_common.py::TestCommon::test_window_title PASSED tests/test_navigation.py::TestNavigation::test_main_page_loaded PASSED ...中間省略 tests/test_performance.py::TestPerformance::test_high_frequency_switch_song PASSED tests/test_performance.py::TestPerformance::test_page_load_time PASSED tests/test_performance.py::TestPerformance::test_memory_leak_during_playback PASSED 46 passed in 865.37s (0:14:25) 測試結(jié)果46個自動化測試用例全部通過通過率100%總耗時約14分25秒。六、發(fā)現(xiàn)的BUG在本次測試過程中發(fā)現(xiàn)以下問題6.1 搜索功能異常問題描述QQ音樂桌面客戶端頂部搜索框輸入關(guān)鍵詞后按回車搜索結(jié)果頁面無法正常加載搜索功能不可用。影響范圍搜索功能完全不可用用戶無法通過搜索查找歌曲、歌手、專輯等內(nèi)容。嚴重程度高處理方式由于搜索功能本身存在異常自動化測試僅覆蓋搜索框的UI層面測試存在性、輸入、焦點、持久化不驗證搜索結(jié)果。該問題需開發(fā)團隊進一步排查。6.2 窗口放大時頁面元素未同步放大問題描述將QQ音樂窗口從默認大小拖拽放大到全屏1920x1080時窗口邊框擴大但頁面內(nèi)部的歌曲列表、封面圖、歌詞區(qū)域等核心內(nèi)容元素沒有隨窗口等比例放大元素仍保持原尺寸導(dǎo)致大窗口下頁面兩側(cè)出現(xiàn)大量空白區(qū)域內(nèi)容集中在窗口中間視覺效果不協(xié)調(diào)。復(fù)現(xiàn)步驟啟動QQ音樂窗口保持默認大小拖拽窗口右下角將窗口放大到接近全屏觀察頁面內(nèi)容區(qū)域預(yù)期結(jié)果頁面內(nèi)容元素隨窗口大小等比例放大或自適應(yīng)填充充分利用窗口空間。實際結(jié)果頁面元素尺寸不變大窗口下兩側(cè)留白過多內(nèi)容未自適應(yīng)填充。影響范圍大屏用戶體驗不佳窗口空間未充分利用。嚴重程度中6.3 小窗口下控件重疊問題描述將窗口縮小到800x600及以下尺寸時底部播放控制欄的播放/暫停、上一曲、下一曲、音量、播放模式等按鈕出現(xiàn)重疊部分按鈕被遮擋無法正常點擊。復(fù)現(xiàn)步驟啟動QQ音樂拖拽窗口邊緣將窗口縮小到800x600觀察底部播放控制欄預(yù)期結(jié)果窗口縮小時控件自適應(yīng)排列不重疊、不越界核心按鈕可正常點擊。實際結(jié)果底部播放欄按鈕重疊部分按鈕被遮擋無法點擊。影響范圍小窗口或低分辨率屏幕用戶無法正常操作播放控制欄。嚴重程度中6.4 取消收藏后列表不立即刷新問題描述在我喜歡頁面點擊紅心取消收藏某首歌曲后該歌曲仍保留在當前列表展示中不會立即從列表中移除。需要切換到其他導(dǎo)航頁面再重新進入我喜歡頁面列表才會刷新取消收藏的歌曲才會消失。復(fù)現(xiàn)步驟進入我喜歡頁面確保列表中有收藏的歌曲點擊第一首歌左側(cè)的紅心取消收藏觀察當前列表預(yù)期結(jié)果取消收藏后該歌曲立即從當前列表中移除列表實時刷新。實際結(jié)果取消收藏后歌曲仍在列表中需切換頁面再返回才會刷新。影響范圍用戶取消收藏后無法即時看到效果可能誤以為取消收藏失敗而重復(fù)操作。嚴重程度低6.5 自繪控件可訪問性限制問題描述QQ音樂本地下載列表和我喜歡列表基于Qt框架自繪渲染UIAUI Automation無法暴露列表項的文本內(nèi)容和子元素結(jié)構(gòu)導(dǎo)致自動化測試無法直接獲取歌曲名、歌手名等信息也無法直接定位紅心收藏按鈕的狀態(tài)。影響范圍自動化測試對列表項的操作只能通過坐標點擊實現(xiàn)穩(wěn)定性和可維護性低于標準控件收藏按鈕的狀態(tài)已收藏/未收藏無法通過UIA斷言需人工確認同時也影響屏幕閱讀器等無障礙工具的使用。嚴重程度低產(chǎn)品層面為可訪問性問題測試層面為技術(shù)限制處理方式采用坐標點擊播放器文本間接驗證的方案覆蓋核心功能視覺類驗證高亮樣式、圖標渲染采用截圖保存人工確認的方式。建議開發(fā)團隊在自繪控件中實現(xiàn)UIA Provider提升無障礙訪問能力。七、測試總結(jié)以及建議7.1 測試總結(jié)本次QQ音樂桌面客戶端測試覆蓋功能測試、UI布局測試、性能測試三大維度共設(shè)計并執(zhí)行了46個自動化測試用例和若干手工測試用例測試結(jié)果如下功能測試客戶端啟動、導(dǎo)航切換、本地下載管理、我喜歡收藏、底部播放控制、窗口操作等核心功能均正常運行功能完整性和正確性達標。UI布局測試客戶端在不同窗口大小下控件自適應(yīng)排列無重疊、無越界選中高亮、收藏圖標、音質(zhì)標簽等視覺元素正常渲染。性能測試高頻切歌場景下CPU和內(nèi)存占用在合理范圍內(nèi)無崩潰頁面加載耗時達標長時間持續(xù)播放無明顯內(nèi)存泄漏。自動化測試46個自動化測試用例全部通過通過率100%自動化回歸測試體系搭建完成。7.2 優(yōu)化建議修復(fù)搜索功能搜索功能是音樂客戶端的核心入口當前搜索功能異常嚴重影響用戶體驗建議開發(fā)團隊優(yōu)先排查修復(fù)。提升控件可訪問性建議開發(fā)團隊在自繪控件中實現(xiàn)UIA Provider暴露列表項文本和子元素結(jié)構(gòu)提升無障礙訪問能力和自動化測試可維護性。增加異常場景測試建議補充網(wǎng)絡(luò)斷開、音頻文件損壞、文件移動/刪除后播放等異常場景的測試提升客戶端容錯能力。多系統(tǒng)兼容性測試建議在更多Windows版本W(wǎng)in7/Win8/Win10/Win11和不同分辨率下進行兼容性測試確保全平臺體驗一致。7.3 后續(xù)測試重點搜索功能修復(fù)后回歸測試搜索功能修復(fù)后需補充搜索結(jié)果展示、搜索結(jié)果分類切換、無結(jié)果提示等搜索相關(guān)的自動化測試用例。歌單管理功能測試當前測試未覆蓋歌單創(chuàng)建、歌單編輯、歌單分享等歌單管理功能后續(xù)需補充。會員功能測試會員專屬音質(zhì)、會員專屬曲庫、會員彈窗等會員相關(guān)功能需補充測試。長時間穩(wěn)定性測試建議執(zhí)行24小時以上的長時間穩(wěn)定性測試驗證客戶端在超長運行時間下的內(nèi)存泄漏和崩潰情況。自動化測試持續(xù)集成將自動化測試接入CI/CD流水線實現(xiàn)每次代碼提交后自動回歸測試提升測試效率。附錄附錄A自動化測試環(huán)境搭建安裝Python 3.9及以上版本克隆項目到本地項目代碼shturl.cc/GrRCImEPeijhCSDZq8TH4jSeyJmqiOGkwzxXz5GoeD3qDlM創(chuàng)建虛擬環(huán)境python -m venv .venv激活虛擬環(huán)境.venv\Scripts\activate安裝依賴pip install -r requirements.txt修改config/config.yaml中的QQ音樂路徑和測試音樂目錄運行測試python run.py附錄B測試運行命令# 運行全部測試python run.py# 按模塊運行python run.py smoke# 冒煙測試python run.py navigation# 導(dǎo)航測試python run.py player# 播放器測試python run.pylocal# 本地下載頁python run.py like# 我喜歡頁python run.py ui# UI布局測試python run.py performance# 性能測試python run.py core# 核心功能# 查看報告# HTML報告直接用瀏覽器打開 reports/report.html# Allure報告allure serve reports/allure-results附錄C性能測試閾值配置指標閾值說明高頻切歌平均CPU≤80%20次連續(xù)切歌場景高頻切歌峰值CPU≤90%允許短暫峰值高頻切歌內(nèi)存增長≤100MB切歌前后內(nèi)存差值切歌成功率≥90%20次切歌成功比例頁面加載平均耗時≤5000ms導(dǎo)航到本地下載頁長時間播放內(nèi)存增長率≤10%前后半段平均內(nèi)存對比最終內(nèi)存/初始內(nèi)存≤150%2分鐘播放后內(nèi)存比值