NetCoreServer(C 13 / .NET 9)Linux 基准测试实现:路由、构建与验证全解析
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):
- Plaintext:
/plaintext,实现在 Benchmarks/HttpBenchmarkSession.cs - JSON:
/json,同样实现在 Benchmarks/HttpBenchmarkSession.cs
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 逻辑包含以下检查:
- 路由长度:
plaintext_url至少 10 个字符(/plaintext恰好满足); - 响应体内容:响应体必须包含
hello, world!(大小写不敏感),超出基准要求的额外字节会给出性能告警; - 响应头:必须存在
Server、Date、Content-Type,且Content-Type需匹配text/plain(; charset=UTF-8)(大小写不敏感),并带有Content-Length或Transfer-Encoding; - Date 校验:
Date头必须符合 RFC 1123 格式(%a, %d %b %Y %H:%M:%S %Z); - 禁止缓存:间隔 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 的验证规则:
- 路由长度:
json_url至少 5 个字符(/json恰好满足); - JSON 结构:响应必须是合法 JSON 对象,且必须包含键
message,其值须为hello, world!(键名与值均大小写不敏感),多余键值对会产生告警; - 响应头:
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 测试,可参考以下流程(仓库为只读资源,无需修改任何文件):
- 仅验证服务正确性(不压测):
./tfb --mode verify --test netcoreserver
--mode verify 会构建并启动测试容器、请求 /plaintext 与 /json 并按上文规则校验响应,随后自动关闭。
- 运行完整基准(包含 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 的参数定义)。
- 手动本地运行(调试用):
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# 基准测试的起点。