NetCoreServer(C 13 / .NET 9)Linux 基准测试实现:路由、构建与验证全解析

原创2026-10-14 11:57:471,909 阅读
文章标签:性能测试测试质量保障后端示例工程Web框架

NetCoreServer(C# 13 / .NET 9)Linux 基准测试实现:路由、构建与验证全解析

本文以 TechEmpower FrameworkBenchmarks 仓库中 frameworks/CSharp/netcoreserver 的 README.md 为主体,深入解析 NetCoreServer 框架在 Linux 平台上的基准测试实现。你将了解该测试的版本选型(C# 13.0、.NET 9)、/plaintext 与 /json 两条路由的源码实现、工程与镜像构建配置,以及 Toolset 中对应的自动化验证规则,能够据此独立复现、修改或扩展该基准测试。

一、测试项目概览

netcoreserver 是 FrameworkBenchmarks 仓库中基于 NetCoreServer。它面向 Linux 平台,仅实现两个无需数据库的测试类型:Plaintext 与 JSON,这是 README 明确列出的核心内容。

从 benchmark_config.json 可以看到该测试在 Benchmark 平台上的完整元数据声明:

配置项 值 说明
framework netcoreserver 测试标识名
approach Realistic 测试方式归类(贴近真实场景)
classification Fullstack 框架分类为全栈型
database None 不依赖数据库
language C# 实现语言
orm Raw 未使用 ORM,直接处理数据
platform .NET 运行平台
webserver NetCoreServer 内嵌 Web 服务器
os Linux 目标操作系统
port 8080 服务监听端口

同名配置也以 TOML 形式维护在 config.toml,其中 urls.plaintext = "/plaintext"、urls.json = "/json" 与 JSON 配置保持一致,供 Toolset 读取。

二、基础设施版本选型(README 核心信息)

README 的 "Infrastructure Software Versions" 一节明确了本测试的技术栈版本,这是参与 Benchmark 运行的前提约束:

  • 语言(Language):C# 13.0
  • 平台(Platforms):.NET 9
  • Web 服务器(Web Servers):NetCoreServer

这一选型在 Benchmarks.csproj 中得到了直接印证:<TargetFramework>net9.0</TargetFramework>、<LangVersion>13.0</LangVersion>,并以 PackageReference 方式引入 NetCoreServer 8.0.7。

测试路径与源码(Paths & Source for Tests):

README 明确指出这两条路由都集中在一个会话处理类中实现,接下来我们深入源码一探究竟。

三、源码解析:从入口到路由分发

3.1 程序入口:Program.cs

Program.cs 定义了进程入口,其核心逻辑非常简洁:

var server = new HttpBenchmarkServer(IPAddress.Any, 8080);

AppDomain.CurrentDomain.ProcessExit += (_, __) => WaitEvent.Set();

server.Start();

WaitEvent.WaitOne();

return 0;

要点:

  • 服务监听 IPAddress.Any(即 0.0.0.0)的 8080 端口,与 benchmark_config.json 中的 port 字段一致;
  • 通过 ManualResetEvent 配合 ProcessExit 事件实现优雅阻塞,容器退出时触发 WaitEvent.Set();
  • 异常路径打印异常并返回 -1,finally 中调用 server.Stop() 确保资源释放。

3.2 服务器类型:HttpBenchmarkServer

HttpBenchmarkServer.cs 继承自 NetCoreServer 的 HttpServer 基类,仅做两件事:

protected override TcpSession CreateSession()
{
    return new HttpBenchmarkSession(this);
}

protected override void OnError(SocketError error)
{
    Console.WriteLine($"HTTP session caught an error: {error}");
}

这是 NetCoreServer 的典型扩展模式:每个客户端连接会通过 CreateSession 创建一个 TcpSession 派生实例,本测试将其替换为自定义的 HttpBenchmarkSession。

3.3 路由处理核心:HttpBenchmarkSession

HttpBenchmarkSession.cs 是 README 中点名引用的核心文件,继承自 HttpSession,在 OnReceivedRequest 中完成两条路由的分发:

protected override void OnReceivedRequest(HttpRequest request)
{
    if (request.Url.StartsWith("/plaintext"))
    {
        SendResponseAsync(MakeResponse("Hello, World!", "text/plain; charset=UTF-8"));
    }
    else if (request.Url.StartsWith("/json"))
    {
        var value = new JsonResult() { Message = "Hello, World!" };
        var serialized = JsonSerializer.Serialize(value);

        SendResponseAsync(MakeResponse(serialized, "application/json; charset=UTF-8"));
    }
    else
    {
        SendResponseAsync(Response.MakeErrorResponse(404, "Not found"));
    }
}

路由实现要点:

  • /plaintext:直接返回固定字符串 Hello, World!,Content-Type 为 text/plain; charset=UTF-8;
  • /json:构造 JsonResult 对象(Message = "Hello, World!"),通过 System.Text.Json 的 JsonSerializer.Serialize 序列化后返回,Content-Type 为 application/json; charset=UTF-8;
  • 其他路径:一律返回 404 错误响应。

响应构造通过私有静态方法 MakeResponse 完成:

private static HttpResponse MakeResponse(string value, string contentType)
{
    var response = new HttpResponse(200, "OK", "HTTP/1.1");

    response.SetHeader("Server", "NetCoreServer");
    response.SetHeader("Date", DateTime.UtcNow.ToString("r"));
    response.SetHeader("Content-Type", contentType);

    response.SetBody(value);

    return response;
}

这里显式设置了 Server、Date、Content-Type 三个响应头,并基于 UtcNow 生成 RFC 1123 格式的 Date。正如后文所述,这些头字段恰好是 Toolset 验证逻辑的硬性要求。JsonResult 则是一个极简的密封类,见 JsonResult.cs:

public sealed class JsonResult
{
    public string Message { get; set; }
}

四、工程配置与性能相关参数

Benchmarks.csproj 中除了版本信息,还包含两个对基准测试性能有直接影响的编译开关:

配置项 值 作用
<TargetFramework> net9.0 目标框架 .NET 9
<LangVersion> 13.0 启用 C# 13.0 语法特性
<ServerGarbageCollection> true 启用服务器 GC 模式,更适合高并发服务吞吐
<TieredCompilation> false 关闭分层编译,避免因基准预热导致的方法调用层切换
<StartupObject> Benchmarks.Program 显式指定入口类型
<OutputType> Exe 生成可执行程序

依赖项仅有两个 NuGet 包:NetCoreServer(8.0.7)与 System.Text.Json(9.0.10)。值得注意的是项目文件中的 AssemblyTitle 仍写作 "EmbedIO Benchmarks",属于历史遗留命名,不影响构建与运行。

五、容器化构建:netcoreserver.dockerfile

netcoreserver.dockerfile 采用标准的 .NET 两阶段构建策略:

FROM mcr.microsoft.com/dotnet/sdk:9.0-alpine AS build
WORKDIR /source

# 先复制 csproj 并单独执行 restore,充分利用 Docker 层缓存
COPY Benchmarks/*.csproj .
RUN dotnet restore -r linux-musl-x64

# 复制全部源码并发布
COPY Benchmarks/ .
RUN dotnet publish -c release -o /app -r linux-musl-x64 --no-restore --self-contained

# 运行阶段使用 runtime-deps 镜像
FROM mcr.microsoft.com/dotnet/runtime-deps:9.0-alpine
WORKDIR /app
COPY --from=build /app .

ENTRYPOINT ["./Benchmarks"]

EXPOSE 8080

构建细节解读:

  • 第一阶段:使用带 SDK 的 9.0-alpine 镜像;先只复制 *.csproj 执行 dotnet restore -r linux-musl-x64,使依赖恢复结果成为独立的 Docker 层,源码变更时无需重新下载依赖;
  • 发布参数:--self-contained 生成自包含可执行程序,因此运行阶段选用不含运行时/SDK 的精简镜像 dotnet/runtime-deps:9.0-alpine;
  • 目标运行时:linux-musl-x64 与 Alpine 镜像的 musl libc 相匹配;
  • 运行入口:ENTRYPOINT ["./Benchmarks"] 直接执行发布产物,端口 8080 由 EXPOSE 声明。

六、Toolset 中的自动化验证规则

netcoreserver 的测试由仓库根目录的 tfb 入口脚本(参见 tfb 与 entrypoint.sh)驱动 toolset/run-tests.py 执行。该脚本支持 --type 选择测试类型(all、json、plaintext 等),以及 --mode verify(仅启动服务、发起请求并校验后关闭)等运行模式。

针对 netcoreserver 实现的两条路由,验证规则定义在两个测试类型模块中:

6.1 Plaintext 验证(/plaintext)

toolset/test_types/plaintext/plaintext.py 的 verify 逻辑包含以下检查:

  1. 路由长度:plaintext_url 至少 10 个字符(/plaintext 恰好满足);
  2. 响应体内容:响应体必须包含 hello, world!(大小写不敏感),超出基准要求的额外字节会给出性能告警;
  3. 响应头:必须存在 Server、Date、Content-Type,且 Content-Type 需匹配 text/plain(; charset=UTF-8)(大小写不敏感),并带有 Content-Length 或 Transfer-Encoding;
  4. Date 校验:Date 头必须符合 RFC 1123 格式(%a, %d %b %Y %H:%M:%S %Z);
  5. 禁止缓存:间隔 3 秒的两次请求若返回相同 Date 值,则判定失败。

可见 HttpBenchmarkSession.cs 中基于 DateTime.UtcNow.ToString("r") 动态生成 Date 头、设置 Server: NetCoreServer 与 text/plain; charset=UTF-8 的写法,正是为了通过上述全部检查项。

6.2 JSON 验证(/json)

toolset/test_types/json/json.py 的验证规则:

  1. 路由长度:json_url 至少 5 个字符(/json 恰好满足);
  2. JSON 结构:响应必须是合法 JSON 对象,且必须包含键 message,其值须为 hello, world!(键名与值均大小写不敏感),多余键值对会产生告警;
  3. 响应头:Content-Type 需匹配 application/json(; charset=UTF-8),同时复用与 Plaintext 相同的头字段与 Date 缓存校验。

verify_helloworld_object 与 verify_headers 的具体实现位于 toolset/test_types/verifications.py。JsonSerializer.Serialize(new JsonResult { Message = "Hello, World!" }) 产出的 {"Message":"Hello, World!"} 恰好满足"键名大小写不敏感"的匹配策略,因此无需任何自定义序列化配置即可通过验证。

七、本地验证与运行方式

若要在本机验证 netcoreserver 测试,可参考以下流程(仓库为只读资源,无需修改任何文件):

  1. 仅验证服务正确性(不压测):
./tfb --mode verify --test netcoreserver

--mode verify 会构建并启动测试容器、请求 /plaintext 与 /json 并按上文规则校验响应,随后自动关闭。

  1. 运行完整基准(包含 wrk 压测):
./tfb --test netcoreserver --type plaintext,json

tfb 脚本会创建 tfb Docker 网络、构建 Toolset 镜像,并将 /var/run/docker.sock 与仓库根目录挂载进容器,从而在隔离环境中完成构建、验证、压测与结果采集(默认并发级别为 16/32/64/128/256/512,单轮时长默认 15 秒,参见 toolset/run-tests.py 的参数定义)。

  1. 手动本地运行(调试用):
dotnet restore -r linux-musl-x64
dotnet publish -c release -o /app -r linux-musl-x64 --no-restore --self-contained

随后直接执行 ./Benchmarks,服务即监听 8080 端口,可用 curl 访问验证:

curl -i http://localhost:8080/plaintext
curl -i http://localhost:8080/json

八、总结

netcoreserver 测试以极简的两路由实现(/plaintext 与 /json)覆盖了 Benchmark 中最基础的两个无数据库测试类型。其价值体现在三处清晰的对应关系:README 声明版本(C# 13.0 / .NET 9)→ csproj 编译配置 → Dockerfile 基础镜像(sdk:9.0-alpine / runtime-deps:9.0-alpine);路由路径(/plaintext、/json)→ HttpBenchmarkSession.OnReceivedRequest 分发逻辑 → benchmark_config.json 的 URL 元数据;响应格式 → Toolset 的 verify 校验规则(Content-Type、Date、message 键等)。理解这条从声明到源码再到验证的完整链路,是向该仓库贡献或复刻 C# 基准测试的起点。

登录后查看全文
FrameworkBenchmarks