ProxySQL 测试流水线深度解析:从 TAP 单元测试到多平台 CI/CD 与第三方集成验证

  • 后端
  • 数据库
  • 负载均衡

【免费下载链接】proxysql

High-performance proxy for MySQL and PostgreSQL

项目地址: https://gitcode.com/gh_mirrors/pr/proxysql
点击查看 免费下载

ProxySQL 是一个面向 MySQL 与 PostgreSQL 的高性能代理(proxy),其代码质量保障依赖一套多层次、可自动化的测试基础设施。本文以仓库文档 TEST-PIPELINE.md 为骨架,结合真实源码与 CI 工作流,系统讲解 ProxySQL 的 TAP 测试框架、ASAN 内存安全测试、测试分组机制、第三方连接器集成测试、覆盖率收集、性能基准以及 GitHub Actions 编排流水线,帮助读者理解如何在本地复现测试、读懂 CI 判定规则,并掌握为 ProxySQL 贡献新测试的规范。

测试流水线总体架构

ProxySQL 的测试流水线分为四层,自下而上逐级叠加验证强度:

  1. 触发层(Trigger Layer):Pull Request、分支推送(push)、手动调度(workflow_dispatch)以及定时任务(scheduled)四类事件触发流水线。
  2. CI 编排层(CI Orchestration):以 CI-trigger.yml 为主编排器,负责条件过滤与下游工作流调度。
  3. 核心测试流水线(Core Test Pipelines):TAP 功能测试、ASAN 内存安全测试、SSL/TLS 安全测试、测试组(Test Groups)与 Make 构建验证。
  4. 第三方集成测试(Third-Party Integration Tests):MySQL/PgSQL 官方连接器、Python ORM、PHP PDO、JDBC 驱动、Web 框架的兼容性验证。

mermaid

CI-trigger.yml 的实际触发条件(见 CI-trigger.yml):

  • pull_request:默认触发,但忽略 .github/** 与 **.md 的变更,避免纯文档改动空跑整套流水线;
  • push:仅匹配 v[0-9].[0-9x]+... 形式的版本分支;
  • workflow_dispatch:支持手动触发,便于维护者定点复测。

它通过 concurrency 分组实现"同一分支的新提交自动取消进行中的旧流水线"(cancel-in-progress: true),并使用 ci:skip 标签放行跳过。真正的执行逻辑位于 sysown/proxysql/.github/workflows/ 下的可复用工作流(reusable workflows)中,本仓库的入口文件仅做引用与参数透传。

TAP 框架与核心功能测试

TAP(Test Anything Protocol)基础设施

ProxySQL 的核心功能测试基于 TAP 协议实现,测试二进制位于 test/tap/tests/,目前包含 300 多个独立测试文件。TAP 框架本身是一个以 C++ 绑定实现的自定义版本,源码头位于 test/tap/tap/tap.h 与 test/tap/tap/tap.cpp。

该框架源自 MySQL 的 MyTAP 库(见 tap.h 中版权与作者注释),提供了四个最核心的 API:

  • plan(count):声明本次测试计划执行的断言总数;
  • ok(pass, fmt, ...):执行一条断言,失败时输出描述信息;
  • skip(how_many, reason):跳过若干断言并说明原因;
  • exit_status():汇总所有失败断言并返回进程退出码。

其中 plan() 的实现(见 tap.cpp)还会读取环境变量 MYTAP_CONFIG:当其值不为 "big" 时,skip_big_tests 被置为 1,即默认跳过长耗时测试,只有显式声明 MYTAP_CONFIG=big 才会运行完整套件。同时框架会安装 SIGSEGV、SIGABRT 等信号处理器用于崩溃现场处理。

一个最简测试用例(见 basic-t.cpp):

#include <stdlib.h>
#include "tap.h"

int main() {
  plan(5);
  ok(1 == 1, "testing basic functions");
  ok(2 == 2, " ");
  ok1(3 == 3);
  if (1 == 1)
    skip(2, "Sensa fragoli");
  else {
    ok(1 == 2, "Should not be run at all");
    ok(1, "This one neither");
  }
  return exit_status();
}

输出格式符合 TAP 规范:

ok 1 - testing basic functions
ok 2 -
ok 3 -
ok 4 # skip Sensa fragoli
ok 5 # skip Sensa fragoli
1..5

测试目录结构

根据 test/tap/README.md,test/tap/ 下的目录分工如下:

目录用途
tap/TAP 辅助库与跨测试共享的通用工具(tap.cpp、utils.cpp、command_line.cpp、cluster_simulator.cpp、noise_utils.cpp 等)
tests/单元测试与功能测试主目录
tests_with_deps/需要额外编译依赖的测试
groups/按基础设施与配置划分的测试组

测试二进制统一以 -t 后缀命名,例如 basic-t、test_mysql_connect-t。构建规则由 test/tap/tests/Makefile 定义,其中集中链接了仓库 deps/ 下的全部依赖库(MariaDB client、libconfig、libev、libhttpserver、re2、pcre2、libinjection、PostgreSQL libpq、libscram、libusual、OpenSSL、protobuf、SQLite3 等),这也是 TAP 测试能够直接驱动真实 MySQL/PgSQL 协议的前提。

测试类别概览

类别覆盖范围代表性测试文件
基础功能连接处理、SQLite 配置basic-t.cpp、sqlite3-t.cpp
MySQL 协议线协议解析、认证mysql-*.cpp(50+ 文件)
PostgreSQL 协议SASL/SCRAM、协议处理pgsql-*.cpp(20+ 文件)
Admin 接口配置、统计admin_*.cpp
查询处理规则、缓存、路由test_query_*.cpp
预处理语句二进制协议、元数据stmt_*.cpp、ps_*.cpp
连接管理连接池、故障转移test_connection_*.cpp
复制感知读写分离test_aurora_*.cpp、test_galera_*.cpp
安全TLS、认证方法test_ssl_*.cpp、test_auth_*.cpp
性能/压力内存、吞吐test_ps_large_*.cpp

测试警告日志机制

test/tap/tests/README.md 还说明了一个面向调试的细节:除少数例外,所有 TAP 测试都默认开启"警告计数 + 触发警告的查询"日志。其实现方式是覆写 MariaDB 客户端库的特定 API 来提取警告计数与对应查询,如需关闭可在编译期定义预处理宏 DISABLE_WARNING_COUNT_LOGGING。

内存安全测试(ASAN/TSAN)

ProxySQL 将内存安全验证独立成一条流水线。主 Makefile(Makefile)给出了标准编译方式:

# 编译依赖、主程序与 TAP 测试,全部开启 ASAN
make build_deps_debug -j$(nproc) && make debug -j$(nproc) && make build_tap_test_debug -j$(nproc)

关键点在于两个环境变量:

  • NOJEMALLOC=1:ASAN 与 jemalloc 分配器不兼容,必须先禁用 jemalloc;
  • WITHASAN=1:开启 AddressSanitizer 插桩。

文档中的 ASAN 构建示例(make build_tap_tests_debug NOJEMALLOC=1 WITHASAN=1)与仓库 Makefile 的 build_tap_tests_debug 目标(见 Makefile)一致,两者等价。运行时可配合:

export ASAN_OPTIONS=abort_on_error=0:halt_on_error=0:print_stats=1

ASAN 流水线覆盖内存泄漏、缓冲区溢出、use-after-free 三类问题。仓库中对应的实际工作流为 CI-unit-tests-asan-coverage.yml(ASAN 与覆盖率合并执行),另有 CI-unit-tests-tsan.yml 专门跑 ThreadSanitizer(TSAN)线程竞争检测。需要注意:原文档中提到的 CI-taptests-asan.yml、CI-taptests-ssl.yml 工作流文件名在当前仓库中已不存在,实际以 CI-unit-tests-asan-coverage.yml、CI-unit-tests-tsan.yml、CI-unittests.yml 等为准——这也印证了文档顶部"NON-VERIFIED,需对照源码核实"的提示。

Makefile 同时说明(Makefile):若改用 Valgrind 运行,SQLite 内部内存分配器会在 pcache*、memjrnl*、sqlite3Btree* 产生误报,需以 -USQLITE_ENABLE_MEMORY_MANAGEMENT 重新编译 SQLite 规避。

测试组(Test Groups)与多样化配置

分组机制

单个 TAP 测试往往需要在多种后端版本与配置下重复执行,为此 test/tap/groups/ 引入了"测试组"概念。组的元数据统一记录在 groups.json(约 700 行),其格式为"测试名 → 组名数组"的单行紧凑 JSON:

{
  "admin-listen_on_unix-t" : [ "legacy-g1","mysql84-g1","mysql90-g1" ],
  "basic-t" : [ "legacy-g1","mysql84-g1" ]
}

借助 grep 即可快速检索:grep "basic-t" groups.json 查看某测试所属组,grep "unit-tests-g1" groups.json 查看某组包含的测试。组命名遵循 <base>-g<N> 约定:<base> 是组名(如 legacy、mysql84),<N> 是用于并行分片的子组编号,系统会去掉 -gN 后缀以定位基础组目录。

组目录结构

根据 test/tap/groups/README.md,每个基础组在 test/tap/groups/<base>/ 下维护以下文件:

文件用途
env.sh组级环境变量,由 runner 早期 source
infras.lst所需后端基础设施清单(每行一个)
setup-infras.bash所有后端启动完成后执行的钩子
pre-proxysql.bash测试执行前运行的钩子(如集群搭建)
pre-cleanup.bash测试结束后、容器拆除前执行的钩子

此外,groups/ 下还附带了 check_groups.py、lint_groups_json.py、lint_group_coverage.py 等校验脚本,以及针对组分片正确性的测试脚本(如 test_ai_group_shards.py),说明分组配置本身也被纳入 CI 检查(对应工作流 CI-lint-groups-json.yml)。

特殊分组示例

当前仓库中确认存在的测试组包括:

  • legacy-g1 ~ legacy-g10:标准配置;
  • mysql-multiplexing=false:关闭多路复用(对应 mysql-multiplexing=false-g1);
  • mysql-query_digests=0:关闭查询摘要;
  • mysql-query_digests_keep_comment=1:保留注释的摘要;
  • mysql84、mysql90、mysql93、mysql95 系列:版本特化;
  • mysql84-gr、mysql90-gr、mysql93-gr、mysql95-gr:MySQL Group Replication;
  • mariadb10-galera:MariaDB Galera 集群;
  • mysqlx-e2e、mysqlx-tsan-g1:MySQL X Protocol 端到端/TSAN;
  • unit-tests:无基础设施纯单元测试;
  • no-infra-g1:不依赖 ProxySQL 与后端的组;
  • ai-g1、ai-g2:GenAI/MCP 相关模块测试(此类条目在 groups.json 中带有 @proxysql_min_version:4.0 版本约束标记)。

组级配置通过在组目录放置 SQL/Bash 前置脚本实现。test/tap/README.md 给出了创建自定义组的完整流程:

TG='mytests'
mkdir -p test/tap/tests_grp_$TG
cd test/tap/tests_grp_$TG
for T in $(ls -1 ../tests/); do ln -fsT ../tests/$T $T; done
cat > pre-test_grp_$TG-proxysql.sql << EOF
SET mysql-multiplexing='false';
LOAD MYSQL VARIABLES TO RUNTIME;
EOF

持久化配置策略(重要约束)

test/tap/README.md 强调了一条铁律:TAP 测试器会在每个测试之间从磁盘恢复 ProxySQL 配置,因此普通测试二进制及其 setup/teardown 辅助脚本禁止执行 SAVE ... TO DISK——那会把测试状态写入持久化配置、污染后续测试的基线。正确做法是只修改内存中的 admin 表并通过 LOAD ... TO RUNTIME 生效;仅当"持久化本身是被测行为"时(例如测试 SAVE 语义)才允许写盘,且必须在退出前恢复原始磁盘配置。一次性测试组基线(pre-proxysql 脚本)属于例外,可以保存组基线但绝不能保存单测状态。

第三方连接器与 ORM 集成测试

ProxySQL 面向真实生态,因此专门维护了一套"第三方测试"(3rd-party testing)矩阵,验证官方驱动与主流 ORM 的兼容性。这些测试的内部测试套件位于私有仓库 priv-infra/proxysql_3p_testing/ 中,属于内部系统(本仓库不可见),本仓库只保留触发它们的 CI 工作流。

数据库连接器矩阵

连接器语言工作流测试重点
MySQL Connector/JJavaCI-3p-mysql-connector-j.ymlJDBC 兼容性、预处理语句
MariaDB Connector/CCCI-3p-mariadb-connector-c.yml原生协议、异步操作
PostgreSQL JDBC(pgjdbc)JavaCI-3p-pgjdbc.ymlPgSQL 协议、SASL 认证
PHP PDO MySQLPHPCI-3p-php-pdo-mysql.ymlPDO 操作、事务
aiomysqlPythonCI-3p-aiomysql.yml异步 MySQL 操作
PostgreSQL libpqCCI-3p-postgresql.yml原生 PostgreSQL 客户端

实际工作流清单比文档更丰富,仓库还包含:CI-3p-mysql-connector-python.yml、CI-3p-mysqlclient.yml、CI-3p-pymysql.yml、CI-3p-psycopg.yml、CI-3p-go-mysql.yml、CI-3p-node-mysql2.yml、CI-3p-php-pdo-pgsql.yml 等,覆盖了 Python、Go、Node.js 生态。

ORM 与框架矩阵

框架技术栈工作流验证内容
SQLAlchemyPython ORMCI-3p-sqlalchemy.ymlORM 操作、连接池
DjangoPython WebCI-3p-django-framework.ymlDjango ORM、迁移
LaravelPHP WebCI-3p-laravel-framework.ymlEloquent ORM、迁移

以 CI-3p-mysql-connector-j.yml 为例,这类工作流都支持 workflow_dispatch 手动指定 testtree(即 proxysql_3p_testing 仓库的分支/tag/hash),方便针对特定内部测试版本复测,并通过 infradb、connector 变量从 GitHub Actions Variables 中注入矩阵配置。

测试执行流水线

本地开发测试

开发者本地即可完成大部分验证,标准流程为:

# 1) 构建测试依赖、debug 版主程序与 TAP 测试
make build_deps_debug
make debug
make build_tap_test_debug

# 2) 运行全部 TAP 测试
cd test/tap/tests
./run_tests.sh

# 3) 运行指定测试类别(单测二进制)
./test_mysql_connect-t
./test_pgsql_authentication-t

单个 TAP 二进制可直接执行(返回码即测试结果),也可通过环境变量覆盖连接目标运行:

TAP_HOST=127.0.0.1 TAP_PORT=6033 ./test_query_cache-t

CI/CD 自动化执行

在 CI 中,执行时序如下:

mermaid

本仓库的消费者工作流(如 CI-legacy-g1.yml)都通过 workflow_run 事件监听 CI-trigger 的完成,只有 CI-trigger 成功后才启动,并支持手动 workflow_dispatch 复测。concurrency 与 cancel-in-progress: true 保证同一分支的重复提交自动替换旧任务。

测试环境变量

变量默认值含义
TAP_HOST / TAP_PORT127.0.0.1 / 6033ProxySQL 前端监听地址与端口
TAP_USERNAME / TAP_PASSWORDroot / rootProxySQL 管理账号
MYSQL_HOST / MYSQL_PORT127.0.0.1 / 3306MySQL 后端地址
PGSQL_HOST / PGSQL_PORT127.0.0.1 / 5432PostgreSQL 后端地址
SKIP_BIG_TESTS=1开启跳过长时间运行的测试(与 MYTAP_CONFIG 机制对应)
EXTENDED_TESTS=0关闭是否运行扩展测试套件
WITHASAN=1关闭启用 ASAN 插桩
WITHGCOV=1关闭启用 gcov 覆盖率收集

其中 SKIP_BIG_TESTS 的实现依据正是 tap.cpp:框架根据 MYTAP_CONFIG 是否为 "big" 决定是否跳过大型测试,plan() 在每次测试开始时读取该环境变量。

覆盖率分析流水线

覆盖率收集被设计为多阶段、跨语言合并的流程:

mermaid

覆盖率的采集构建与报告生成:

# 带 gcov 插桩构建源码
make build_src_debug WITHGCOV=1

# 运行测试收集覆盖率数据
./test/tap/tests/run_tests.sh

# 用 fastcov 并行处理 gcno/gcda 并生成 lcov 格式报告
fastcov -b -j$(nproc) --process-gcno -l \
    -e /usr/include/ test/tap/tests \
    -d . -i include lib src \
    -o coverage_report.info

# 生成带分支覆盖率的 HTML 报告
genhtml --branch-coverage coverage_report.info \
    --output-directory coverage_html/

覆盖率目标(按文档约定,属于内部监控指标):

组件目标覆盖率关键函数
核心库(lib/)80%协议处理器、会话管理
主程序(src/)70%main 入口、TLS、SQLite Server
Admin 接口75%配置、统计
查询处理器85%路由、缓存、重写

性能测试流水线

性能验证由 test/PrepStmt/ 下的多客户端压力测试驱动(见 test/PrepStmt/),每个客户端模拟不同负载模式:

client1.cpp   - 简单预处理语句执行
client2.cpp   - 批量插入操作
client3.cpp   - 复杂事务模式
client10.cpp  - 最大连接数压力

基准测试类别与关注指标:

测试类型位置指标阈值
查询吞吐test_query_cache_*QPS无回归
连接池test_connection_*连接数/秒>1000/s
内存占用test_*_memory_*RSS/VSZ基线 <2GB
延迟test_fast_routing_*p99 延迟<10ms
协议开销test_compression_*CPU 占用<5% 开销

说明:上表阈值取自原文档,属于质量门禁设定而非实测数据,具体判定以 CI 中的基线比较结果为准。

回归测试

回归测试统一以 reg_test_*.cpp 命名(如 reg_test_3456_crash_fix-t.cpp、mysql-reg_test_4707_threshold_resultset_size-t.cpp),形成四类覆盖:

  • Bug 修复:每个已修复 bug 配套一条回归用例;
  • 协议问题:MySQL/PostgreSQL 协议层回归;
  • 性能:性能回归检测;
  • 安全:安全漏洞回归。

仓库 test/tap/tests/ 中 reg_test_* 文件超过 100 个,其中大量条目直接以 issue 号命名(如 reg_test_3371_prepared_statement_crash-t.cpp、reg_test_4935-caching_sha2-t.cpp),可追溯到具体缺陷,是"每个 bug 一条回归"策略的直接证据。

mermaid

安全测试

安全测试分四类展开:

  1. 认证测试:MySQL 原生认证、caching_sha2_password、PostgreSQL SASL/SCRAM、LDAP 认证插件(对应测试如 test_auth_methods-t.cpp、pgsql-auth_method_matrix-t.cpp、reg_test_4935-caching_sha2-t.cpp、pgsql-verifier_auth-t.cpp);
  2. SQL 注入防御:libinjection 集成测试、查询防火墙验证、模式匹配测试(对应 test_firewall-t.cpp,依赖 deps/libinjection);
  3. SSL/TLS 校验:证书校验、密码套件测试、协议版本强制(对应 test_ssl_*.cpp、ssl_ciphers-t.cpp、pgsql-monitor_ssl_connections_test-t.cpp);
  4. 访问控制:用户权限测试、查询规则执行、连接数限制。

Docker 测试环境

多平台构建矩阵

顶层 docker-compose.yml 定义了 _build 基础服务,统一透传 MAKE、WITHGCOV、NOJEMALLOC、WITHASAN、WITHTSAN、PROXYSQL_BUILD_TYPE、PROXYSQL40 等构建环境变量(见 docker-compose.yml),各发行版服务(centos9/debian12/ubuntu24 等)通过 extends 继承并覆盖镜像与 PKG_RELEASE。例如:

services:
  centos9_build:
    extends:
      service: _build
    image: proxysql/packaging:build-centos9-v4.0.0
    environment:
      - PKG_RELEASE=centos9
      - PROXYSQL_BUILD_TYPE=clickhouse

  debian12_build:
    extends:
      service: _build
    image: proxysql/packaging:build-debian12-v4.0.0
    environment:
      - PKG_RELEASE=debian12
      - PROXYSQL_BUILD_TYPE=debug
      - WITHASAN=1

  ubuntu24_build:
    extends:
      service: _build
    image: proxysql/packaging:build-ubuntu24-v4.0.0
    environment:
      - PKG_RELEASE=ubuntu24
      - PROXYSQL_BUILD_TYPE=clickhouse
      - WITHGCOV=1

与之对应,.github/workflows/ 下存在 CI-package-amd64-*、CI-package-arm64-* 两套大型打包验证矩阵(含 almalinux8/9/10、centos9/10、debian12/13、fedora42-44、opensuse16、ubuntu22/24 及 clang/dbg/genai/v31 变体),用于验证各平台上的安装与运行。

测试场景拓扑

docker/scenarios/ 提供可直接 docker-compose up 的测试拓扑:

  • 单后端:docker/scenarios/1backend/docker-compose.yml 仅含 1 个 ProxySQL 容器(映射 6032/6033 管理端口与主端口,卷挂载 /tmp/proxysql-tests 供调试)与 1 个 MySQL 后端(宿主机 13306 映射 3306,root 密码 root),适合基础功能与连接测试;
  • 复制拓扑:docker/scenarios/5backends-replication/docker-compose.yml 包含 1 个 ProxySQL 与 1 主 4 从(master-conf.d、slave1-conf.d ~ slave4-conf.d),用于读写分离与复制感知测试;
  • 另有 docker/scenarios/repl1/ 场景及 docker/images/proxysql 下的镜像构建素材(entrypoint、spec/ctl 打包脚本)。

持续集成工作流详解

PR 验证流水线

mermaid

代码检查环节对应的工作流包括 CI-codeql.yml(CodeQL 静态分析)、CI-maketest.yml(构建验证)与 scripts/lint/ 下的 clang-tidy/cppcheck 规范化脚本(见 run-local.sh)。

测试矩阵的组织方式

  • 通用组工作流:CI-legacy-g1.yml 至 CI-legacy-g10.yml、CI-basictests.yml、CI-selftests.yml、CI-no-infra-g1.yml;
  • 版本特化工作流:CI-mysql84-g1.yml ~ CI-mysql84-g9.yml、CI-mysql84-gr-g*.yml、CI-mysql90-*、CI-mysql93-gr-g1、CI-mysql95-*、CI-mariadb10-galera-g*.yml、CI-mariadb10-binlog-g1.yml、CI-mysql56-single-g1.yml;
  • 专项工作流:CI-repltests.yml、CI-cluster-simulator.yml、CI-pg-compat.yml、CI-pgsql-socket-g1.yml、CI-shuntest.yml、CI-mysqlx*.yml、CI-ai-g*.yml、CI-macos-unit-smoke.yml、CI-unittests.yml、CI-unit-tests-asan-coverage.yml、CI-unit-tests-tsan.yml。

Nightly 扩展测试

夜间任务会运行完整扩展套件:全部测试组、全部第三方连接器、性能基准、内存泄漏检测与安全扫描,作为常规 PR 流水线的补充深度验证。

测试报告与质量指标

TAP 输出与失败定位

TAP 输出被聚合工具解析,格式示例:

ok 1 - Connection established
ok 2 - Query executed successfully
not ok 3 - Prepared statement failed
# Failed test 3: Expected 1 row, got 0
1..3

GitHub Actions 侧的呈现方式包括:PR 评论中的测试摘要、每个测试类别的独立 status check、失败日志的 artifact 上传、覆盖率徽章与报告。

质量指标仪表盘

指标目标趋势
测试成功率>99%↑
代码覆盖率>75%→
测试执行时长<30min↓
不稳定测试(flaky)率<1%↓

这些为目标值而非当前实测值;仓库中确有专门治理 flaky/不稳定测试的手段,如 test/tap/noise/(噪声注入)与 NOISE_TESTING.md、test_noise_injection-t.cpp,以及 rand10_*、rand5_admin_1 等随机分片组用于暴露时序问题。

新测试编写最佳实践

  1. 使用 TAP 框架:所有测试必须基于 plan()/ok()/skip()/exit_status() 输出 TAP 格式,便于统一解析;
  2. 测试隔离:测试之间不得相互依赖,单个测试失败不应影响后续;
  3. 资源清理:必须清理连接与临时资源(遵守上文"禁止 SAVE TO DISK"策略,用 LOAD ... TO RUNTIME 管理内存配置);
  4. 超时处理:为长时间操作设置合理超时;
  5. 文档化:在测试头部说明测试目的与前置条件。

命名约定:

// test_<feature>_<scenario>-t.cpp
test_mysql_connect_basic-t.cpp      // 基础连接测试
test_pgsql_auth_scram-t.cpp         // SCRAM 认证测试
reg_test_3456_crash_fix-t.cpp       // bug #3456 的回归测试

配置管理可通过独立 env 文件按测试加载:

cat > test_config.env << EOF
MYSQL_VERSION=8.0
PROXYSQL_CONFIG=test.cnf
ENABLE_DEBUG_OUTPUT=1
EOF

source test_config.env
./run_tests.sh

测试失败排查

问题诊断解决方案
连接超时检查 ProxySQL 是否正常启动核对配置、查看日志
测试不稳定竞态条件增加同步机制、加大超时
内存泄漏ASAN 报告修复泄漏、更新测试清理逻辑
覆盖率缺口低覆盖区域补充针对性测试

调试信息收集手段:

# 开启调试输出与 TAP 详细日志
export PROXYSQL_TEST_DEBUG=1
export TAP_VERBOSE=1

# 收集 coredump(ASAN 构建下 coredump 功能需 WITHASAN=0,见 Makefile 注释)
ulimit -c unlimited
export PROXYSQL_COREDUMP_DIR=/tmp/cores/

# 保存详细日志
./test_failing-t 2>&1 | tee test_debug.log

未来增强方向

原文档列出的演进方向包括:混沌测试(故障注入)、自动化性能回归检测、Kubernetes Operator 容器测试、REST API 综合测试、GDPR/HIPAA 合规性验证。其中部分能力在仓库中已见雏形:test/tap/noise/ 的噪声注入测试(NOISE_TESTING.md)与 test_noise_injection-t.cpp 已提供故障注入实验基础,reg_test_3223-restapi_return_codes-t.cpp、reg_test_4055_restapi-t.cpp 等已覆盖 REST API 状态码与回归场景。

结语

ProxySQL 的测试流水线本质上是"一套 TAP 内核 + 矩阵式分组 + 多语言第三方集成 + 多平台打包验证"的组合工程:TAP 框架(源自 MyTAP)保证测试的轻量与可解析,groups.json 与组钩子脚本把同一测试扩展到多种后端版本和配置,ASAN/TSAN/覆盖率工作流把关内存与分支覆盖,CI-3p-* 系列则守住与真实生态的兼容底线。对于想深入参与贡献的开发者,最直接的入手路径是:先读懂 test/tap/README.md 的配置纪律与 groups.json 的映射规则,再对照 test/tap/tests/ 中已有的 reg_test_* 用例撰写自己的回归测试,最后在本地用 make build_tap_test_debug 验证并通过 CI 矩阵确认多版本兼容性。

  • 后端
  • 数据库
  • 负载均衡

【免费下载链接】proxysql

High-performance proxy for MySQL and PostgreSQL

项目地址: https://gitcode.com/gh_mirrors/pr/proxysql
点击查看 免费下载

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值