test

test/ 目录说明

本目录存放联调脚本、抓包样本、驱动手工测试笔记及配置归档。运行时网关以数据库为配置源（internal/config → data/config.db），下列文件不直接被 go test 加载，供文档引用、手工联调或导入参考。

目录结构

说明：根目录曾有的 v2 示例 YAML（config_v2_three_level.yaml、config_multi_slave.yaml、channels.yaml）已移除，避免与 docs/deployment/ 及 conf/ 示例重复。现行 schema 与片段见下方「配置参考」；历史全量见 legacy/。

配置参考（v2 三级架构）

运行时以 data/config.db 为准；下列为文档与联调用的参考来源，非 CI 依赖。

v2 schema 要点

channels:                          # 第一级：采集通道（驱动 + 连接参数）
  - id: "modbus-tcp-1"
    protocol: "modbus-tcp"
    config:
      url: "tcp://127.0.0.1:502"
    devices:                       # 第二级：从站/设备（每 slave_id 一个 Device）
      - id: "slave-1"
        interval: 5s
        config:
          slave_id: 1              # Modbus Unit ID
        points:                    # 第三级：点位
          - id: "dev1_temp"
            address: "40001"
            datatype: "int16"

采集由 ScanEngine 按 Device interval 调度；同通道多从站通过 config.slave_id + 驱动内 SetSlaveID 实现。

Legacy 归档

已废弃的 devices + slaves: 嵌套格式及全量配置快照见 legacy/：

请勿用于新部署或 CI。

常用 go test 命令

单元测试覆盖率门禁（2026-07-05）

门禁阈值：internal/core 语句覆盖率 ≥ 60%（-short 友好）。

CGO_ENABLED=0 go test ./internal/core/... -short -count=1 -coverprofile=/tmp/core_cover.out
go tool cover -func=/tmp/core_cover.out | tail -1

明细见 ScanEngine重构测试报告 §2.8、南向驱动测试报告 §八。

南向采集通道回归（2026-07-04 门禁）

与 南向采集通道回归验证测试方案 §五 一致；日志输出至 docs/testing/_run_logs/：

# Week1 自动化 gate（按序执行）
CGO_ENABLED=0 go test ./internal/core/... -short -count=1
CGO_ENABLED=0 go test ./internal/driver/... -short -count=1
CGO_ENABLED=0 go test ./internal/integration/... -short -count=1
make test-soak-short          # SOAK_DURATION=30 可覆盖
make bench-q3
make bench-g007

联机回归（A–G）步骤与排期见方案 §八；资产见本目录 manual/ 与 legacy/。

默认 CI 友好包（与用户验收命令一致）：

# 核心 + BACnet + SNMP + 配置（-short 跳过长跑/压测）
CGO_ENABLED=0 go test ./internal/core/... \
  ./internal/driver/bacnet/... \
  ./internal/driver/snmp/... \
  ./internal/config/... \
  -short -count=1

Makefile 目标（make 在仓库根目录）：

其他常用片段：

# 全仓（macOS 上 internal/server、internal/sync 等可能因 TLS 链接失败）
CGO_ENABLED=0 go test ./... -short -count=1

# 仅集成层短测
CGO_ENABLED=0 go test ./internal/integration/... -short -count=1

# Q3 万 Tag 基准（非 short）
CGO_ENABLED=0 go test ./internal/core/ -run TestQ3_TenThousandTagBenchmark -count=1 -timeout=15m

相关文档

• 测试验证索引 — SLA 压测、Soak、南向驱动验收报告
• 三级架构快速入门
• 多从站指南
• 南向驱动矩阵

测试维护原则

CI 与本地 go test ./... 以现行实现为准。测试腐化时按下列规则处理，勿留占位或重复：

macOS 链接失败（SecTrustCopyCertificateChain）：Go 工具链与 macOS SDK 版本不匹配所致，非业务代码问题。升级 Go / Xcode Command Line Tools，或在 Linux CI 上跑全量测试；internal/server、internal/sync 等依赖 TLS 的包在旧 macOS 上可能无法链接。

边缘计算压测（2026-07-05）

CGO_ENABLED=0 go test ./internal/core/ -run EdgeComputeStress -count=1 -timeout 180s -v
CGO_ENABLED=0 go test ./internal/core/ -run '^$' -bench=BenchmarkEdgeCompute -benchtime=1s -count=1