Pr/fix sse timeout global exception handler

[zhaieryuan]

Summary

• What changed?
  fix exception handle npe
• Why is this needed?

Validation

• [ y] Backend tests passed
• [ y] Frontend typecheck/build passed
• [ y] OpenAPI SDK regenerated or checked when API contracts changed
• [ y] Smoke test run when relevant

Commands run:

# paste commands here

Risk

• User-facing impact:
• Deployment or migration impact:
• Rollback approach:

Notes

• Related issue:
• Follow-up work:
• Docs or operator runbooks updated when behavior changed:
  feat : 调整sse 超时 GlobalExceptionHandler 拦截异常

See :
rg.springframework.web.context.request.async.AsyncRequestTimeoutException: null
at org.springframework.web.context.request.async.TimeoutDeferredResultProcessingInterceptor.handleTimeout(TimeoutDeferredResultProcessingInterceptor.java:42) ~[spring-web-6.1.4.jar:6.1.4]
at org.springframework.web.context.request.async.DeferredResultInterceptorChain.triggerAfterTimeout(DeferredResultInterceptorChain.java:81) ~[spring-web-6.1.4.jar:6.1.4]
at org.springframework.web.context.request.async.WebAsyncManager.lambda$startDeferredResultProcessing$5(WebAsyncManager.java:430) ~[spring-web-6.1.4.jar:6.1.4]
at java.base/java.util.ArrayList.forEach(ArrayList.java:1596) ~[na:na]
at org.springframework.web.context.request.async.StandardServletAsyncWebRequest.onTimeout(StandardServletAsyncWebRequest.java:149) ~[spring-web-6.1.4.jar:6.1.4]
at org.apache.catalina.core.AsyncListenerWrapper.fireOnTimeout(AsyncListenerWrapper.java:44) ~[tomcat-embed-core-10.1.19.jar:10.1.19]
at org.apache.catalina.core.AsyncContextImpl.timeout(AsyncContextImpl.java:136) ~[tomcat-embed-core-10.1.19.jar:10.1.19]
at org.apache.catalina.connector.CoyoteAdapter.asyncDispatch(CoyoteAdapter.java:135) ~[tomcat-embed-core-10.1.19.jar:10.1.19]
at org.apache.coyote.AbstractProcessor.dispatch(AbstractProcessor.java:243) ~[tomcat-embed-core-10.1.19.jar:10.1.19]
at org.apache.coyote.AbstractProcessorLight.process(AbstractProcessorLight.java:57) ~[tomcat-embed-core-10.1.19.jar:10.1.19]
at org.apache.coyote.AbstractProtocol$ConnectionHandler.process(AbstractProtocol.java:896) ~[tomcat-embed-core-10.1.19.jar:10.1.19]
at org.apache.tomcat.util.net.NioEndpoint$SocketProcessor.doRun(NioEndpoint.java:1744) ~[tomcat-embed-core-10.1.19.jar:10.1.19]
at org.apache.tomcat.util.net.SocketProcessorBase.run(SocketProcessorBase.java:52) ~[tomcat-embed-core-10.1.19.jar:10.1.19]
at org.apache.tomcat.util.threads.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1191) ~[tomcat-embed-core-10.1.19.jar:10.1.19]
at org.apache.tomcat.util.threads.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:659) ~[tomcat-embed-core-10.1.19.jar:10.1.19]
at org.apache.tomcat.util.threads.TaskThread$WrappingRunnable.run(TaskThread.java:63) ~[tomcat-embed-core-10.1.19.jar:10.1.19]
at java.base/java.lang.Thread.run(Thread.java:1583) ~[na:na]

[wowo-zZ]

已补充修复这次 SSE timeout 处理的几个问题：

1. 原实现对 /sse 超时直接 return null，异常处理行为不稳定；现改为显式返回 204 No Content，让 SSE 客户端按预期重连。
2. 原实现对非 SSE 的 AsyncRequestTimeoutException 返回裸 408 空响应，不符合项目统一 API envelope；现改为返回标准错误体。
3. 原实现使用 contains("/sse") 判断路径，匹配范围过宽；现收紧为 endsWith("/sse")。
4. 补充了 GlobalExceptionHandlerTest 回归测试，并新增中英文超时文案。

验证：make test-backend-app 已通过，366 个测试通过。

[zhaieryuan]

666666

…

---- Replied Message ---- | From | ***@***.***> | | Date | 03/30/2026 11:03 | | To | iflytek/skillhub ***@***.***> | | Cc | eryuan ***@***.***>, Author ***@***.***> | | Subject | Re: [iflytek/skillhub] Pr/fix sse timeout global exception handler (PR #178) | wowo-zZ left a comment (iflytek/skillhub#178) 已补充修复这次 SSE timeout 处理的几个问题： 原实现对 /sse 超时直接 return null，异常处理行为不稳定；现改为显式返回 204 No Content，让 SSE 客户端按预期重连。 原实现对非 SSE 的 AsyncRequestTimeoutException 返回裸 408 空响应，不符合项目统一 API envelope；现改为返回标准错误体。 原实现使用 contains("/sse") 判断路径，匹配范围过宽；现收紧为 endsWith("/sse")。 补充了 GlobalExceptionHandlerTest 回归测试，并新增中英文超时文案。 验证：make test-backend-app 已通过，366 个测试通过。 — Reply to this email directly, view it on GitHub, or unsubscribe. You are receiving this because you authored the thread.Message ID: ***@***.***>