Skip to content

fix(dashboard): 回放管线拒收输入时保留首个处理器失败 - #24

Merged
JohnWuY merged 1 commit into
mainfrom
fix/replay-pipeline-20261116
Nov 16, 2026
Merged

JohnWuY merged 1 commit into
mainfrom
fix/replay-pipeline-20261116

Conversation

@JohnWuY

@JohnWuY JohnWuY commented Nov 16, 2026

Copy link
Copy Markdown
Collaborator

问题

夜间用例 B020004(FFT 保存波形按历史设置重新计算,CRYDAQ_DASHBOARD_LARGECHANNELTHRESHOLD=0,WAV_ONLY)在查看历史回放时失败。服务日志只有:

java.lang.IllegalStateException: ProcessorPipeline no longer accepts input
    at DefaultProcessorPipeline.accept(DefaultProcessorPipeline.java:208)
    at RecordedMeasurementExecution.acceptInput(RecordedMeasurementExecution.java:435)
    at RecordedMeasurementReplaySession.acceptInput(RecordedMeasurementReplaySession.java:157)
    at DashboardWavReplayRunner.run(DashboardWavReplayRunner.java:107)

这是二次异常。管线先因某个节点失败而停止,回放源继续送帧才报出它,第一个失败没有进日志。

根因

用夜间运行留下的真实 WAV(10 秒、192 kHz、32 位)、actual.json 里的 FFT 配置(BASEBAND、2048 线)和真实的 opentest-fft-tools.jar 在本地复现,拿到了首个失败:

Caused by: java.lang.IllegalArgumentException: Recorded frame has no unique saved result target
    at RecordedMeasurementReplaySession.acceptFrame(RecordedMeasurementReplaySession.java:174)
    at PersistResultSinkProcessor.onFrame(PersistResultSinkProcessor.java:112)

FFT 频谱图选的是 Vrms。查看回放用 RECORDED_STREAM,计划器按显示单位把结果目标定成 Hz/Vrms;FFT 插件的 FftPersistence.connect 只在 RECORDED_GRAPHIC_EXPORT 时插入单位换算节点,查看回放时直接输出 FS 频谱帧。会话核对单位失败,管线在第一个 2048 点窗口就停了。

单位不一致属于 OpenTest-Plugins 的 FFT 插件,本 PR 不包含它的修复。本地验证过:把 FftPersistence.connect 的条件改成对两种回放用途都插入 FftGraphicUnitsProcessor 后,RECORDED_STREAM/Vrms、RECORDED_STREAM/FS、RECORDED_GRAPHIC_EXPORT/Vrms 三种组合都能完整回放 937 帧。

改动

  • DefaultProcessorPipeline 拒收输入时,把管线已记录的首个失败作为 cause,并写进报错文字。没有失败的正常停止,报错不变。之后同类问题在日志和客户端都能直接看到真正原因。
  • ProcessorErrorPolicyContractTest:处理器失败后再送帧,拒收异常带有原始失败。
  • RecordedMeasurementReplaySessionTest:用 10 秒、192 kHz、32 位 WAV 经默认 50 ms 帧多帧回放,每 2048 点发一个 FS 频谱帧给 Vrms 目标,断言报错带出 “no unique saved result target”。

验证

  • 修复前:两条新测试都失败;会话测试的报错与生产环境一致,只有 “ProcessorPipeline no longer accepts input”。
  • 修复后:opentest-dashboard-api 221 个测试、opentest-dashboard-standard-processors 95 个测试全部通过;crydaq-service 中 replay 和 recording 包的 256 个测试里,新测试通过。
  • crydaq-service 里另有 5 个类共 6 个失败、18 个错误(DashboardWavHistoricalArtifactAdapterTest、FiniteStreamingCaptureResourcesTest、SharedFlatFilePublicationJournalTest、SharedResultAdmissionSqliteTest、SharedStagePublicationTest)。在未改动的 main(e40cc08)上单独跑,结果完全相同,与本 PR 无关。
  • 未做实机验证;FFT 插件修复合入并重装后,用 B020004 复测。

Refs B020004

WAV_ONLY 历史回放(B020004)中,FFT 查看回放输出 FS 频谱帧,而保存的
目标单位是 Vrms,回放会话的结果核对因此在管线内抛出异常并停止管线。
回放源随后继续送帧,日志里只剩二次异常
"ProcessorPipeline no longer accepts input",首个原因丢失。

管线拒收输入时把已记录的首个失败作为 cause,并写进报错文字。
正常停止后拒收的报错不变。

补两条测试:管线契约测试覆盖处理器失败后的拒收;回放会话测试用
10 秒、192 kHz、32 位 WAV 按 50 ms 多帧回放,每 2048 点发一个 FS 频谱帧
给 Vrms 目标,断言报错带出首个失败。

FS/Vrms 不一致本身属于 FFT 插件(OpenTest-Plugins),另行修复。
@JohnWuY
JohnWuY requested a review from a team November 16, 2026 03:56

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AI 代码审查(claude-opus-5-5)

改动方向正确:拒收输入时把已记录的首个处理器失败作为 cause 带出,且没有失败的正常停止时报错文字保持不变,能直接解决 B020004 中只看到二次异常、看不到根因的问题。主要问题在会话层新测试的断言:它无法区分异常是从“拒收输入”路径抛出,还是从管线完成失败路径直接抛出,因此不能确定地覆盖本次修复。

其他意见:

  • 按 CONTRIBUTING.zh-CN.md,拉取请求应使用 Refs #<编号> 关联 GitHub Issue。B020004 是夜间用例编号,不是 Issue,测试复验后无法按流程关闭。建议补建或关联对应 Issue。
  • 根因修复在 OpenTest-Plugins 的 FftPersistence.connect,本 PR 只改善了诊断。建议在 Issue 中跟踪插件侧修复,并在描述中注明 B020004 合入本 PR 后仍会失败,避免被误认为已修复。

由 AI 自动生成,仅供参考,不作为合并依据。审查提交:f82155d。维护者可评论 /review 重新审查。

failure = assertThrows(RuntimeException.class, () -> session.run(timeline, new DashboardReplayCancellationToken(),
pressure, new ReplayWriteTracker(pressure), null));
}
assertTrue(failure.getMessage().contains("no unique saved result target"), failure::toString);

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟠 中 当前两条断言不能确定地验证本次修复路径:

  • 如果会话从管线 completion() 直接抛出包装后的原始失败(例如 CompletionException(IllegalArgumentException)),消息中也含 “no unique saved result target”,getCause() 也是 IllegalArgumentException,测试同样通过。
  • 回放源能否在管线停止后再次调用 accept,取决于失败传播与送帧的时序。修复前测试失败依赖的是本地时序,不是确定条件。

建议补充断言,锁定异常确实来自拒收路径,例如:

var rejected = assertInstanceOf(IllegalStateException.class, failure);
assertTrue(rejected.getMessage().startsWith("ProcessorPipeline no longer accepts input"));

如果会话会再包装一层,就沿 cause 链定位。也可以在 ProcessorErrorPolicyContractTest 已覆盖确定性语义的前提下,把本测试定位为端到端回归,并在注释中说明它不保证走拒收路径。

private IllegalStateException rejectedInput() {
Throwable cause = failure.get();
String message = "ProcessorPipeline no longer accepts input";
return new IllegalStateException(cause == null ? message : message + ": " + cause, cause);

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 低 每次拒收都会新建一个以同一 failure 对象为 cause 的异常。如果上层(如 DashboardWavReplayRunner 或会话收尾)按常见写法把完成失败作为主异常,并把 accept 抛出的异常 addSuppressed 到它上面,就会形成 original → suppressed(ISE) → cause(original) 的循环引用。JDK 的 printStackTrace 能处理这种循环,但自行遍历 cause/suppressed 链的代码不一定能处理,例如错误转 gRPC 状态详情或结构化日志,可能重复输出或陷入死循环。

本 diff 看不到上层的合并逻辑,所以不能确定一定会出现这种情况。建议确认调用方在主异常与拒收异常的 cause 相同时,不再把拒收异常加为 suppressed。

var row = channel(); row.setVchId("Ch1"); row.setSamplingRate(192000); row.setBitDepth(32); row.setVp(2.8D);
var channel = MeasureProviderInputs.channel(row);
var wav = directory.resolve("Ch1.wav");
var samples = new double[192000 * 10];

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 低 测试在内存中生成 192 万个 double(约 15 MB),并写出约 7.7 MB 的 32 位 WAV。但失败发生在第一个 2048 点窗口,即第一帧内。复现“失败后回放源继续送帧”只需要几帧。建议把时长缩短到例如 0.5 秒(约 10 帧),并相应调整 InputClock 和 timeline 时长,以减少单元测试的耗时和磁盘占用。采样率和位深可以保留,以贴近生产条件。

@JohnWuY
JohnWuY merged commit 6a05f99 into main Nov 16, 2026
11 of 13 checks passed
@JohnWuY
JohnWuY deleted the fix/replay-pipeline-20261116 branch November 16, 2026 04:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants