leonardoce/webtest

PostgreSQL连接性能测试工具

镜像概述

本Docker镜像包含一个小型C++工具，专门用于测试PostgreSQL数据库在每个请求建立新连接场景下的工作负载速度。该工具通过HTTP接口提供简单的测试能力，适合评估数据库在频繁新建连接时的性能表现。

核心功能与特性

• 连接模式：每个HTTP请求建立一个新的PostgreSQL连接，不使用连接池
• SQL执行：可通过环境变量配置自定义SQL查询，在访问/tx端点时执行
• 健康检查：提供固定端点/.well-known/check，始终返回"ok"，便于监控
• 轻量设计：基于C++开发，依赖少，运行效率高

使用场景

• 测试PostgreSQL在高频新建连接场景下的响应性能
• 评估数据库连接建立开销对整体系统性能的影响
• 验证数据库在无连接池情况下的稳定性和吞吐量

配置说明

通过环境变量进行配置：

主要端点

• /.well-known/check：健康检查端点，返回"ok"
• /tx：执行SQL_QUERY中配置的SQL查询

使用方法

基本运行命令

bash
docker run -d \
  -e DATABASE_URL="postgresql://user:password@postgres-host:5432/testdb" \
  -e SQL_QUERY="SELECT 1" \
  -p 8080:8080 \
  docker.xuanyuan.run/leonardoce/webtest

测试示例

1. 启动容器后，通过以下命令检查健康状态：

   bash
   curl http://localhost:8080/.well-known/check
   # 预期响应：ok
   

2. 执行SQL查询测试：

   bash
   curl http://localhost:8080/tx
   # 响应将包含SQL查询的执行结果
   

注意事项

• 无连接池：本工具设计为每个请求新建连接，不包含连接池功能。如需连接池管理，建议配合pgbouncer使用
• 性能影响：高频请求可能会对PostgreSQL服务器造成连接压力，测试时需注意数据库负载

Docker镜像信息

镜像地址：https://hub.docker.com/r/leonardoce/webtest

致谢

本工具基于https://github.com/yhirose/cpp-httplib%E5%BC%80%E5%8F%91%EF%BC%8C%E6%84%9F%E8%B0%A2%E8%AF%A5%E5%BA%93%E6%8F%90%E4%BE%9B%E7%9A%84HTTP%E6%9C%8D%E5%8A%A1%E8%83%BD%E5%8A%9B%E3%80%82