性能问题优化

本文引用的文件
- README.md - bench/README.md - src/http_stats.v - src/dbx/runtime.v - articles/11-observability.md - php/package/wordpress/v-profiler/v-profiler-ui.js - admin/ui/app.js - src/admin/state.v - src/admin_runtime_context.v - src/provider/config.v - tests/e2e/config_acceptance_test.sh

引言

本指南面向在生产环境中遇到 CPU 使用率过高、内存泄漏、响应时间延迟、并发处理能力不足等问题的工程师，提供系统化的定位与分析方法。内容覆盖： - 运行时监控指标与工具（Admin 平面、事件日志、内置统计） - 性能分析器与内存使用监控（v-Profiler） - 连接池配置、线程池大小调整、缓存策略优化、数据库查询优化 - 负载测试与基准测试（k6）、瓶颈识别与回归检测实践

项目结构

vhttpd 作为协议与执行宿主，围绕 HTTP/WebSocket/流式传输、Worker 编排、上游集成与可观测性展开。与性能相关的关键位置包括： - Admin 管理平面与运行时快照 - Worker 池与队列参数 - 数据库连接池实现 - 内置 HTTP 统计计数 - 压测脚本与回归流程

graph TB
subgraph "运行时"
A["HTTP 统计<br/>src/http_stats.v"]
B["DB 连接池与观察<br/>src/dbx/runtime.v"]
C["Admin 运行时上下文<br/>src/admin_runtime_context.v"]
D["Admin 状态聚合<br/>src/admin/state.v"]
E["Admin UI 指标渲染<br/>admin/ui/app.js"]
F["WordPress v-Profiler UI<br/>php/package/.../v-profiler-ui.js"]
end
subgraph "压测与回归"
G["k6 基准说明<br/>bench/README.md"]
H["端到端配置示例<br/>tests/e2e/config_acceptance_test.sh"]
end
I["项目概览与运行方式<br/>README.md"]
J["可观测性文章<br/>articles/11-observability.md"]
I --> A
I --> B
I --> C
I --> D
I --> E
I --> F
I --> G
I --> H
I --> J

图表来源 - README.md - src/http_stats.v - src/dbx/runtime.v - src/admin_runtime_context.v - src/admin/state.v - admin/ui/app.js - php/package/wordpress/v-profiler/v-profiler-ui.js - bench/README.md - tests/e2e/config_acceptance_test.sh - articles/11-observability.md

章节来源 - README.md - bench/README.md

核心组件

HTTP 请求统计：维护请求总数、错误数、超时数、流式请求数与管理动作计数，用于快速评估吞吐与健康度。
DB 连接池与观察：封装 MySQL/PostgreSQL 连接池，记录慢查询、失败次数、最近查询明细，支持空闲探测与初始化 SQL。
Admin 运行时上下文：暴露 worker 池容量、队列深度、后端模式、生命周期等关键指标。
Admin 状态聚合：汇总活跃会话、管道、监听器、能力集与统计信息，供前端展示与外部抓取。
Admin UI 指标面板：将运行时数据可视化，便于快速发现异常。
WordPress v-Profiler：页面级性能剖析，包含耗时瀑布图、SQL 统计、缓存命中率、内存峰值、外部 HTTP 调用等。

章节来源 - src/http_stats.v - src/dbx/runtime.v - src/admin_runtime_context.v - src/admin/state.v - admin/ui/app.js - php/package/wordpress/v-profiler/v-profiler-ui.js

架构总览

从性能视角看，vhttpd 的“入站—调度—执行—出站”链路中，以下环节最易成为瓶颈： - 入站与协议层：HTTP/WebSocket/流式处理 - 调度与 Worker 池：队列积压、可用 Worker 数量 - 执行侧：PHP Worker 或 vjsx 内嵌执行 - 资源访问：数据库连接池、外部 HTTP 调用 - 可观测性：指标采集、事件日志、性能剖析

sequenceDiagram
participant Client as "客户端"
participant Ingress as "协议接入(HTTP/WS/Stream)"
participant Kernel as "内核调度"
participant Pool as "Worker 池/队列"
participant Exec as "逻辑执行(PHP/vjsx)"
participant DB as "DB 连接池"
participant Admin as "Admin 指标/日志"
Client->>Ingress : 发起请求
Ingress->>Kernel : 解析并路由
Kernel->>Pool : 分配 Worker(排队/拒绝)
Pool-->>Kernel : 返回可用 Worker
Kernel->>Exec : 执行业务逻辑
Exec->>DB : 获取连接并执行 SQL
DB-->>Exec : 返回结果
Exec-->>Kernel : 组装响应
Kernel-->>Client : 返回响应
Kernel->>Admin : 更新统计/事件日志

图表来源 - README.md - src/http_stats.v - src/dbx/runtime.v - src/admin_runtime_context.v - src/admin/state.v

详细组件分析

HTTP 统计与可观测入口

统计字段：请求总数、错误数、超时数、流式请求数、管理动作数
用途：快速判断整体健康度、错误率与超时趋势
建议阈值：错误率突增、超时数上升需立即关注

章节来源 - src/http_stats.v - articles/11-observability.md

数据库连接池与慢查询观察

连接池：MySQL 基于通道预创建连接；PostgreSQL 使用官方库连接池
观察指标：总查询/执行次数、失败次数、慢查询计数、最近查询明细（含 SQL 文本、耗时、是否慢查询）
空闲探测：对 MySQL 连接在空闲超过阈值时 ping 并重建
初始化 SQL：每次获取连接后执行 init_sql，确保会话环境一致

flowchart TD
Start(["acquire()"]) --> CheckIdle{"空闲探测开启且超时?"}
CheckIdle --> |是| Ping["ping 连接"]
Ping --> OkPing{"ping 成功?"}
OkPing --> |否| Reconnect["关闭旧连接并新建"]
OkPing --> |是| UseConn["复用连接"]
CheckIdle --> |否| UseConn
UseConn --> ApplyInit["应用 init_sql"]
ApplyInit --> Return(["返回 SessionHandle"])

图表来源 - src/dbx/runtime.v

章节来源 - src/dbx/runtime.v

Admin 运行时上下文与状态聚合

暴露指标：worker 池大小、队列深度、队列容量、队列超时、后端模式、生命周期、MCP 会话数、WebSocket 活跃连接等
状态聚合：整合管道、监听器、能力集与活跃计数，形成统一快照

章节来源 - src/admin_runtime_context.v - src/admin/state.v

Admin UI 指标面板

展示 HTTP 请求总量、错误率、路由数量、WebSockets、运行时长等
通过 Admin API 拉取数据并渲染，辅助快速定位异常

章节来源 - admin/ui/app.js

WordPress v-Profiler 性能剖析

功能：页面级耗时瀑布图、SQL 统计、缓存命中率、内存峰值、外部 HTTP 调用、安全与环境信息等
适用场景：定位 PHP 应用内部热点、慢查询、缓存未命中、外部依赖延迟

章节来源 - php/package/wordpress/v-profiler/v-profiler-ui.js

依赖关系分析

Admin 上下文依赖引擎指标（worker 池、队列、后端模式）
DB 运行时依赖 provider 配置（驱动、主机、端口、用户名、密码、数据库、池大小、空闲探测间隔、init_sql）
Admin UI 依赖 Admin API 提供的运行时快照
v-Profiler 依赖页面注入的性能数据

classDiagram
class HttpStats {
+requests_total
+errors_total
+timeouts_total
+streams_total
+admin_actions_total
+inc_requests()
+inc_errors()
+inc_timeouts()
+inc_streams()
+inc_admin_actions()
}
class DbRuntime {
+open(settings)
+acquire()
+release(session)
+close()
+note_query_observation(op, req, duration_ms, ok, message)
}
class AdminContext {
+worker_queue_depth()
+worker_pool_size()
+worker_backend_mode()
+worker_queue_capacity()
+worker_queue_timeout_ms()
+mcp_active_sessions(now)
}
class ProviderConfig {
+db.pool_name
+db.host
+db.port
+db.username
+db.password
+db.database
+db.pool_size
+db.mysql.idle_ping_ms
+db.mysql.init_sql
}
HttpStats <.. AdminContext : "被聚合到运行时快照"
DbRuntime --> ProviderConfig : "读取连接池配置"
AdminContext --> HttpStats : "引用统计"

图表来源 - src/http_stats.v - src/dbx/runtime.v - src/admin_runtime_context.v - src/provider/config.v

章节来源 - src/provider/config.v