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