diff --git a/.github/workflows/release-baget.yml b/.github/workflows/release-baget.yml index 49b3cf5..2589393 100644 --- a/.github/workflows/release-baget.yml +++ b/.github/workflows/release-baget.yml @@ -31,9 +31,16 @@ jobs: working-directory: . run: dotnet build StdUnit.Tags.sln -c Release --nologo - - name: Test with Coverage + # ⚠ 两个测试项目**分成两步顺序跑**(理由同 release-nuget.yml):`dotnet test` 直接打解决方案会并行 + # 启动多个 testhost,windows-latest 只有 4 个 vCPU,WebUi 的观测流测试(真实轮询循环 + SSE 写循环) + # 与另外上千个用例抢 CPU 后会出现"偶发超时"的假红。 + - name: Test with Coverage (core, net8.0 + net472) working-directory: . - run: dotnet test -c Release --no-build --collect:"XPlat Code Coverage" --results-directory ./TestResults --nologo + run: dotnet test tests/StdUnit.Tags.Tests/StdUnit.Tags.Tests.csproj -c Release --no-build --collect:"XPlat Code Coverage" --results-directory ./TestResults --nologo + + - name: Test with Coverage (net8.0-only) + working-directory: . + run: dotnet test tests/StdUnit.Tags.Tests.NetCoreOnly/StdUnit.Tags.Tests.NetCoreOnly.csproj -c Release --no-build --collect:"XPlat Code Coverage" --results-directory ./TestResults --nologo - name: Upload Coverage to Codecov uses: codecov/codecov-action@v4 diff --git a/.github/workflows/release-nuget.yml b/.github/workflows/release-nuget.yml index ee197f3..b5f7cc2 100644 --- a/.github/workflows/release-nuget.yml +++ b/.github/workflows/release-nuget.yml @@ -38,9 +38,18 @@ jobs: working-directory: . run: dotnet build StdUnit.Tags.sln -c Release --nologo - - name: Test with Coverage + # ⚠ 两个测试项目**分成两步顺序跑**,不要用 `dotnet test` 直接打解决方案: + # 那样 MSBuild 会并行启动多个 testhost(Tests/net8.0 + Tests/net472 + NetCoreOnly), + # 而 windows-latest 只有 4 个 vCPU、WebUi 的观测流测试要跑真实轮询循环 + SSE 写循环, + # 彼此抢 CPU 后 5s 级的等待窗口会偶发超时(2026-11 实测过一次打挂 3 个不相干的用例)。 + # 顺序跑的代价只有十几秒,换来的是"红就是真红"。 + - name: Test with Coverage (core, net8.0 + net472) working-directory: . - run: dotnet test -c Release --no-build --collect:"XPlat Code Coverage" --results-directory ./TestResults --nologo + run: dotnet test tests/StdUnit.Tags.Tests/StdUnit.Tags.Tests.csproj -c Release --no-build --collect:"XPlat Code Coverage" --results-directory ./TestResults --nologo + + - name: Test with Coverage (net8.0-only) + working-directory: . + run: dotnet test tests/StdUnit.Tags.Tests.NetCoreOnly/StdUnit.Tags.Tests.NetCoreOnly.csproj -c Release --no-build --collect:"XPlat Code Coverage" --results-directory ./TestResults --nologo - name: Upload Coverage to Codecov uses: codecov/codecov-action@v4 diff --git a/AGENTS.md b/AGENTS.md index 4d630c0..459ff04 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -128,6 +128,15 @@ StdUnit.Tags.Core 硬件无关的核心抽象 + Schemas/tagsproje - **分隔符**:相对路径一律用 `/` 或 `Path.Combine` 分段,**不要写 `@"Samples\Web\index.xml"`**——反斜杠在 Linux 是合法文件名字符,`Path.Combine` 不会转换,结果是"Windows 上绿、Linux 上 `File.Exists` 失败"。夹具/示例用 `TestPaths.Fixture("Samples", "Web", "index.xml")` 定位。 - **Windows 专有绝对路径**:`C:\base` 在 Linux 上**不是** rooted 路径,`Path.Combine` 的行为会不同(Windows 丢弃前一段、Linux 拼接),于是同一个用例在两个平台上"测的不是同一件事"。需要"绝对路径"语义的数据请用 `TestPaths.TempPath("base")`(运行时由 `Path.GetTempPath()` 拼出,两个平台都真 rooted)。 - 两者都收在 `tests/StdUnit.Tags.Tests/TestPaths.cs`。新增夹具/路径类用例后请在 WSL 上跑一遍 `-f net8.0`(或直接看 CI)。 +- **不要用"短固定窗口"等待异步推进**:WebUi 的观测流测试要跑真实轮询循环 + SSE 写循环,CI runner 只有 4 个 vCPU、 + 且多个测试项目可能同时在跑(`dotnet test` 打解决方案时会并行启动多个 testhost),5s 级的窗口会把"机器忙"变成随机红 + (2026-11 实测一次打挂 3 个互不相干的用例:`Subscribe_FiltersByEntry` / `WriteValue_ParsesEveryBuiltinKind` / `Delta_IsSplitByMaxValuesPerFrame`)。 + - 等待"某事发生了"请用 `StreamTestContext.WaitUntil(...)`(默认 30s,条件成立即返回)或 `WaitUntilAsync`,**不要写 `Task.Delay(150)` 再断言**; + - 等待上限给宽松不会拖慢通过路径,只影响真失败时的反馈时间——所以宁可 30s 也不要 5s; + - 断言"某事**没有**发生"时,必须先用一个**正向信号**证明"轮询确实又推进了"(例如再改一个值并等它到达), + 否则循环停摆也会让负向断言通过(测试失去鉴别力); + - `tests/StdUnit.Tags.Tests.NetCoreOnly/TestProcessSetup.cs` 会在进程启动时抬高线程池最小线程数,避免线程池爬坡造成的假超时; + 两个 release 工作流也据此把测试项目**分成两步顺序跑**。 - **大小写也算"跨平台"**:Linux 文件系统区分大小写,Windows 不区分。写错大小写的路径(例如测试里的 `Schemas/drivers` 而 csproj 的 `Link` 是 `Schemas\Drivers`)在 Windows 上一直绿,一到 Linux CI 就 `DirectoryNotFoundException`。 - **警告:这个坑在 WSL 里测不出来**——`/mnt/d`(DrvFs)同样不区分大小写。要真验证,得把仓库复制到 WSL 的 ext4(`tar` 排除 `bin`/`obj`,删掉 `paket-files/paket.restore.cached` 后 `paket restore`),或直接依赖 CI。 - 需要按名字定位文件/目录时,**大小写必须与产出方(csproj 的 `Link`、`TestPaths.Fixture(...)`)逐字符一致**——不要为了"容错"写成不区分大小写,那恰好把这个坑掩盖掉(我们就是先写成 `SchemaPath("drivers")` 才红的)。写错了就让它在 CI 上红,并顺手核对 csproj。 diff --git a/tests/StdUnit.Tags.Tests.NetCoreOnly/TestProcessSetup.cs b/tests/StdUnit.Tags.Tests.NetCoreOnly/TestProcessSetup.cs new file mode 100644 index 0000000..bd5b1a2 --- /dev/null +++ b/tests/StdUnit.Tags.Tests.NetCoreOnly/TestProcessSetup.cs @@ -0,0 +1,33 @@ +using System; +using System.Runtime.CompilerServices; +using System.Threading; + +namespace StdUnit.Tags.Tests.NetCoreOnly; + +/// +/// 进程级测试设置。
+/// 本程序集里的 WebUi 测试同时跑着"真实轮询循环 + hub 的发送/心跳循环 + SSE 写循环 + 若干真实宿主", +/// 一个用例就要占用 4~6 个线程池线程;而 CI runner 只有 4 个 vCPU,且运行 `dotnet test` 时可能还有别的 testhost 抢 CPU。 +/// 线程池的最小线程数默认等于核数,超出的需求要按"爬坡"策略慢慢补线程——在 5s 级的等待窗口里就会表现为 +/// "偶发超时",与本库代码无关(2026-11 的 CI 上曾同时打挂 3 个互不相干的用例)。 +/// +/// 这里把最小线程数抬高:这些线程绝大多数时间在等待而不是占 CPU,不会拖慢 CI, +/// 但能消掉"续体排队"这类假失败。 +/// +///
+internal static class TestProcessSetup +{ + private const int MinThreads = 64; + + [ModuleInitializer] + internal static void Initialize() + { + ThreadPool.GetMinThreads(out var workerThreads, out var completionPortThreads); + if (workerThreads >= MinThreads && completionPortThreads >= MinThreads) + { + return; + } + + ThreadPool.SetMinThreads(Math.Max(workerThreads, MinThreads), Math.Max(completionPortThreads, MinThreads)); + } +} diff --git a/tests/StdUnit.Tags.Tests.NetCoreOnly/WebUi/StreamTestContext.cs b/tests/StdUnit.Tags.Tests.NetCoreOnly/WebUi/StreamTestContext.cs index 4bb14d5..c1f7b36 100644 --- a/tests/StdUnit.Tags.Tests.NetCoreOnly/WebUi/StreamTestContext.cs +++ b/tests/StdUnit.Tags.Tests.NetCoreOnly/WebUi/StreamTestContext.cs @@ -70,7 +70,12 @@ private static string CreateRoot() return root; } - public static bool WaitUntil(Func condition, int timeoutMs = 5000) + /// + /// 轮询等待条件成立。
+ /// 超时给得宽松(30s)是有意的:条件成立就立刻返回,所以正常路径不受影响;而 CI runner 只有 2 个 vCPU, + /// 线程池爬坡(每秒一两个线程)可能让轮询循环的续体排队数秒——用 5s 当上限会把"机器慢"变成随机失败。 + ///
+ public static bool WaitUntil(Func condition, int timeoutMs = 30_000) { var deadline = DateTime.UtcNow.AddMilliseconds(timeoutMs); while (DateTime.UtcNow < deadline) diff --git a/tests/StdUnit.Tags.Tests.NetCoreOnly/WebUi/TagsStreamCommandsTests.cs b/tests/StdUnit.Tags.Tests.NetCoreOnly/WebUi/TagsStreamCommandsTests.cs index b95c4d7..1e6ec67 100644 --- a/tests/StdUnit.Tags.Tests.NetCoreOnly/WebUi/TagsStreamCommandsTests.cs +++ b/tests/StdUnit.Tags.Tests.NetCoreOnly/WebUi/TagsStreamCommandsTests.cs @@ -15,7 +15,13 @@ namespace StdUnit.Tags.Tests.NetCoreOnly.WebUi; /// public class TagsStreamCommandsTests : IDisposable { - private static readonly TimeSpan Timeout = TimeSpan.FromSeconds(5); + /// + /// 写意图的超时上限。给得宽松是有意的:CI runner 只有 2 个 vCPU,线程池爬坡可能让轮询循环的 + /// 续体排队数秒,5s 的上限会把"机器慢"变成随机失败(实测 INT16 那个用例报过 504)。 + /// 真正要验证"超时"的用例请用 。 + /// + private static readonly TimeSpan Timeout = TimeSpan.FromSeconds(30); + private static readonly TimeSpan ShortTimeout = TimeSpan.FromMilliseconds(200); private readonly ServiceProvider _root; diff --git a/tests/StdUnit.Tags.Tests.NetCoreOnly/WebUi/TagsStreamHubTests.cs b/tests/StdUnit.Tags.Tests.NetCoreOnly/WebUi/TagsStreamHubTests.cs index bac41ba..a955843 100644 --- a/tests/StdUnit.Tags.Tests.NetCoreOnly/WebUi/TagsStreamHubTests.cs +++ b/tests/StdUnit.Tags.Tests.NetCoreOnly/WebUi/TagsStreamHubTests.cs @@ -121,9 +121,14 @@ public async Task Subscribe_FiltersByEntry() StreamTestContext.TagAt(project, "g2/a").Value = (short)22; Assert.True(StreamTestContext.WaitUntil(() => output.Text.Contains("\"raw\":\"22\""))); - await Task.Delay(150); + + // 再用"g2 的第二个值"确认轮询又推进了至少一轮:两个入口是并行轮询的, + // 所以 g1 只要会发增量,早就该在 output 里出现了——不用固定延时去赌调度速度。 + StreamTestContext.TagAt(project, "g2/a").Value = (short)23; + Assert.True(StreamTestContext.WaitUntil(() => output.Text.Contains("\"raw\":\"23\""))); Assert.DoesNotContain("\"raw\":\"11\"", output.Text); + Assert.DoesNotContain("\"path\":\"g1/a\"", output.Text); await StreamTestContext.StopAsync(runCts, run); await StopSubscriberAsync(piperCts, writer); diff --git a/tests/StdUnit.Tags.Tests.NetCoreOnly/WebUi/TagsStreamShutdownTests.cs b/tests/StdUnit.Tags.Tests.NetCoreOnly/WebUi/TagsStreamShutdownTests.cs index 94059db..07b4ba7 100644 --- a/tests/StdUnit.Tags.Tests.NetCoreOnly/WebUi/TagsStreamShutdownTests.cs +++ b/tests/StdUnit.Tags.Tests.NetCoreOnly/WebUi/TagsStreamShutdownTests.cs @@ -19,7 +19,11 @@ namespace StdUnit.Tags.Tests.NetCoreOnly.WebUi; /// public class TagsStreamShutdownTests { - private static readonly TimeSpan Timeout = TimeSpan.FromSeconds(5); + /// + /// "流应当结束"的等待上限。给得宽松是有意的:条件成立就立刻返回,慢的只可能是 CI 的线程池爬坡 + /// (2 核 runner 上每秒才一两个新线程),用 5s 当上限会把"机器慢"变成随机失败。 + /// + private static readonly TimeSpan Timeout = TimeSpan.FromSeconds(30); private static TagsStreamOptions FastOptions() => new() {