【免费下载链接】proxysql
High-performance proxy for MySQL and PostgreSQL
ProxySQL 是一个面向 MySQL 与 PostgreSQL 的高性能代理(proxy),其代码质量保障依赖一套多层次、可自动化的测试基础设施。本文以仓库文档 TEST-PIPELINE.md 为骨架,结合真实源码与 CI 工作流,系统讲解 ProxySQL 的 TAP 测试框架、ASAN 内存安全测试、测试分组机制、第三方连接器集成测试、覆盖率收集、性能基准以及 GitHub Actions 编排流水线,帮助读者理解如何在本地复现测试、读懂 CI 判定规则,并掌握为 ProxySQL 贡献新测试的规范。
测试流水线总体架构
ProxySQL 的测试流水线分为四层,自下而上逐级叠加验证强度:
- 触发层(Trigger Layer):Pull Request、分支推送(push)、手动调度(workflow_dispatch)以及定时任务(scheduled)四类事件触发流水线。
- CI 编排层(CI Orchestration):以 CI-trigger.yml 为主编排器,负责条件过滤与下游工作流调度。
- 核心测试流水线(Core Test Pipelines):TAP 功能测试、ASAN 内存安全测试、SSL/TLS 安全测试、测试组(Test Groups)与 Make 构建验证。
- 第三方集成测试(Third-Party Integration Tests):MySQL/PgSQL 官方连接器、Python ORM、PHP PDO、JDBC 驱动、Web 框架的兼容性验证。
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/J | Java | CI-3p-mysql-connector-j.yml | JDBC 兼容性、预处理语句 |
| MariaDB Connector/C | C | CI-3p-mariadb-connector-c.yml | 原生协议、异步操作 |
| PostgreSQL JDBC(pgjdbc) | Java | CI-3p-pgjdbc.yml | PgSQL 协议、SASL 认证 |
| PHP PDO MySQL | PHP | CI-3p-php-pdo-mysql.yml | PDO 操作、事务 |
| aiomysql | Python | CI-3p-aiomysql.yml | 异步 MySQL 操作 |
| PostgreSQL libpq | C | CI-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 与框架矩阵
| 框架 | 技术栈 | 工作流 | 验证内容 |
|---|---|---|---|
| SQLAlchemy | Python ORM | CI-3p-sqlalchemy.yml | ORM 操作、连接池 |
| Django | Python Web | CI-3p-django-framework.yml | Django ORM、迁移 |
| Laravel | PHP Web | CI-3p-laravel-framework.yml | Eloquent 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 中,执行时序如下:
本仓库的消费者工作流(如 CI-legacy-g1.yml)都通过 workflow_run 事件监听 CI-trigger 的完成,只有 CI-trigger 成功后才启动,并支持手动 workflow_dispatch 复测。concurrency 与 cancel-in-progress: true 保证同一分支的重复提交自动替换旧任务。
测试环境变量
| 变量 | 默认值 | 含义 |
|---|---|---|
TAP_HOST / TAP_PORT | 127.0.0.1 / 6033 | ProxySQL 前端监听地址与端口 |
TAP_USERNAME / TAP_PASSWORD | root / root | ProxySQL 管理账号 |
MYSQL_HOST / MYSQL_PORT | 127.0.0.1 / 3306 | MySQL 后端地址 |
PGSQL_HOST / PGSQL_PORT | 127.0.0.1 / 5432 | PostgreSQL 后端地址 |
SKIP_BIG_TESTS=1 | 开启 | 跳过长时间运行的测试(与 MYTAP_CONFIG 机制对应) |
EXTENDED_TESTS=0 | 关闭 | 是否运行扩展测试套件 |
WITHASAN=1 | 关闭 | 启用 ASAN 插桩 |
WITHGCOV=1 | 关闭 | 启用 gcov 覆盖率收集 |
其中 SKIP_BIG_TESTS 的实现依据正是 tap.cpp:框架根据 MYTAP_CONFIG 是否为 "big" 决定是否跳过大型测试,plan() 在每次测试开始时读取该环境变量。
覆盖率分析流水线
覆盖率收集被设计为多阶段、跨语言合并的流程:
覆盖率的采集构建与报告生成:
# 带 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 一条回归"策略的直接证据。
安全测试
安全测试分四类展开:
- 认证测试: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); - SQL 注入防御:libinjection 集成测试、查询防火墙验证、模式匹配测试(对应
test_firewall-t.cpp,依赖 deps/libinjection); - SSL/TLS 校验:证书校验、密码套件测试、协议版本强制(对应
test_ssl_*.cpp、ssl_ciphers-t.cpp、pgsql-monitor_ssl_connections_test-t.cpp); - 访问控制:用户权限测试、查询规则执行、连接数限制。
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 验证流水线
代码检查环节对应的工作流包括 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等随机分片组用于暴露时序问题。
新测试编写最佳实践
- 使用 TAP 框架:所有测试必须基于
plan()/ok()/skip()/exit_status()输出 TAP 格式,便于统一解析; - 测试隔离:测试之间不得相互依赖,单个测试失败不应影响后续;
- 资源清理:必须清理连接与临时资源(遵守上文"禁止 SAVE TO DISK"策略,用
LOAD ... TO RUNTIME管理内存配置); - 超时处理:为长时间操作设置合理超时;
- 文档化:在测试头部说明测试目的与前置条件。
命名约定:
// 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
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考



