HAM测试指南：编写高质量单元测试与集成测试的最佳实践

发布时间：2026/7/15 15:16:34

HAM测试指南：编写高质量单元测试与集成测试的最佳实践

【免费下载链接】hamBased on the remote memory access capability and high bandwidth of the UB, deterministic duration virtual machine live migration is achieved, addressing planned downtime issues and ensuring system high availability.项目地址: https://gitcode.com/openeuler/ham

前往项目官网免费下载：https://ar.openeuler.org/ar/

openEuler HAM（High Availability Manager）是基于UB的远程内存访问能力和高带宽实现确定性时长虚拟机热迁移的关键组件，有效解决了计划内停机问题并确保系统高可用性。本文将全面介绍如何为HAM项目编写高质量的单元测试与集成测试，帮助开发者快速掌握测试框架使用、测试用例设计及自动化测试流程。

HAM测试框架架构解析 📊

HAM项目采用Google Test（GTest）作为核心测试框架，结合MockCpp进行依赖模拟，构建了完善的测试体系。测试代码主要集中在test/目录下，包含单元测试用例、集成测试配置和自动化脚本。

图1：HAM热迁移架构图（展示了源端与目的端的测试交互流程）

测试目录结构如下：

test/cases/：存放单元测试用例，如test_ham.cpp和test_ham_comm.cpp
test/3rdparty/：包含GTest和MockCpp等测试依赖库
test/conf/：测试配置文件，如config.yaml
test/run_dt.sh：自动化测试执行脚本

环境准备：快速搭建测试环境 ⚙️

1. 源码获取

git clone https://gitcode.com/openeuler/ham cd ham

2. 安装依赖

HAM测试需要GTest和MockCpp支持，项目已集成这些依赖的自动构建流程：

mkdir build && cd build cmake .. -DBUILD_TESTING=ON make -j$(nproc)

3. 验证测试环境

编译完成后，可在build/test目录下找到测试可执行文件ham_dt：

cd build/test ./ham_dt --gtest_list_tests # 列出所有测试用例

单元测试编写指南 ✍️

测试用例组织规范

HAM单元测试采用GTest的TEST_F宏定义测试套件，每个套件对应一个核心模块。例如test_ham.cpp中定义了TestHam测试套件：

TEST_F(TestHam, checkRamBlockTask) { // 测试内存块任务检查逻辑 ASSERT_EQ(ham_check_ramblock(), 0); } TEST_F(TestHam, HandleIoctl) { // 测试IO控制命令处理 struct ioctl_data data = {.cmd = HAM_CMD_START_MIGRATION}; ASSERT_EQ(ham_handle_ioctl(&data), 0); }

关键测试点设计

针对HAM核心功能，建议重点测试以下场景：

内存块管理：测试RamBlock的创建、销毁和状态转换
迁移流程控制：验证迁移开始、暂停、恢复和回滚功能
通信协议处理：测试源端与目的端的TCP/IP通信逻辑
错误处理机制：模拟网络中断、内存不足等异常场景

使用Mock模拟外部依赖

当测试涉及硬件或外部服务依赖时，可使用MockCpp创建模拟对象：

MOCKER(mock_ub_send); // 模拟UB设备发送函数 EXPECT_CALL(mock_ub_send, (const char*, int)) .times(1) .will(return_value(UB_SUCCESS));

集成测试实践 🔄

测试场景设计

集成测试关注模块间协作，HAM项目主要集成测试场景包括：

图2：HAM热迁移详细流程图（展示了PreCopy迁移的关键步骤）

完整迁移流程：从源端准备到目的端恢复的端到端测试
并发迁移测试：模拟多个虚拟机同时迁移的场景
跨节点通信测试：验证不同物理节点间的迁移数据传输

配置文件使用

测试配置文件test/conf/config.yaml可定制迁移参数：

migration: bandwidth: 1024 # MB/s max_retries: 3 timeout: 300 # 秒

执行集成测试

通过run_dt.sh脚本执行集成测试：

cd test ./run_dt.sh --integration # 仅运行集成测试 ./run_dt.sh --coverage # 生成覆盖率报告

测试覆盖率分析 📈

HAM项目已集成gcov覆盖率工具，CMake配置中已添加覆盖率编译选项：

# test/CMakeLists.txt set(CMAKE_CXX_FLAGS " ${CMAKE_CXX_FLAGS} -fprofile-arcs -ftest-coverage") set(CMAKE_C_FLAGS " ${CMAKE_CXX_FLAGS} -fprofile-arcs -ftest-coverage -DDEBUG_UT")

生成覆盖率报告步骤：

执行所有测试用例
运行lcov生成覆盖率数据：

lcov --capture --directory . --output-file coverage.info genhtml coverage.info --output-directory coverage_report

打开coverage_report/index.html查看详细报告

自动化测试与CI集成 🤖

测试脚本使用

test/run_dt.sh提供丰富的测试控制选项：

--gtest_filter：过滤执行特定测试用例
--valgrind：使用Valgrind检测内存泄漏
--log-level：设置日志输出级别

CI配置建议

在CI流水线中添加以下测试步骤：

test: script: - mkdir build && cd build - cmake .. -DBUILD_TESTING=ON - make -j$(nproc) - cd test && ./run_dt.sh --coverage artifacts: paths: - build/test/coverage_report/