Harden flaky nginx content-type smoke test in Docs build (child-repo .md routes)
维护者通常 1 天内回复
@B4nan 已经在做这个了。
开始于 2026年7月28日。
评估
这个 Issue 还没有评估数据。
描述
What needs to change
The post-build nginx smoke test in .github/workflows/test.yaml (the 🧪 Checking Nginx responses... block) asserts content types with single-shot curls and no retry — assert_header and assert_final_content_type. A single transient response fails the whole Docs build job.
Add a bounded retry with backoff (e.g. 3 attempts ~2s apart) inside those two helpers, so a one-off blip is absorbed while a genuinely broken route still fails every attempt (coverage unchanged).
Why
The check intermittently red-Xes unrelated PRs. On #2827 it failed on:
assert_header ".../sdk/python/docs/changelog.md" "Content-Type" "text/markdown"
❌ got text/html
It's demonstrably nondeterministic: two consecutive builds on that branch — the baseline commit passed this assertion, a README-only commit failed it, and a plain re-run (no code change) went green. Master is not persistently affected. Each occurrence costs a manual re-run and erodes trust in the required checks.
Scope note: retry is the pragmatic fix. The deeper root cause — why a child-repo .md variant occasionally serves text/html before the markdown variant is ready — may deserve separate investigation into the nginx content-negotiation / try_files for child repos.
Source
- Flaky failure on #2827 (failed run, passed on re-run).
- Assertion helpers:
.github/workflows/test.yaml. - Content-negotiation check originally added in #2032.
- 主要语言
- JavaScript
- 星标
- 82
- 派生
- 240
- 平均合并
- 4 天 2 小时
- 30 天内合并 PR
- 44
环境准备
- 没有 Dockerfile 或 Docker Compose 文件
- 有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
apify/apify-docs 的其他 Issue
-
难度 1/5 1 小时以内 新手友好度 85/100
apify/apify-docs#3071 ·
维护者通常 1 天内回复
-
难度 1/5 1 小时以内 新手友好度 85/100
apify/apify-docs#3049 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 68/100
apify/apify-docs#2742 ·
维护者通常 1 天内回复
-
难度 1/5 1-3 小时 新手友好度 82/100
apify/apify-docs#2741 ·
维护者通常 1 天内回复
-
low priority t-unblocking tech enhancement
难度 2/5 1-3 小时 新手友好度 65/100
apify/apify-docs#2451 ·
维护者通常 1 天内回复
相似的 Issue
-
[scanner] check:spelling skips blog/ — posts and author metadata are never spell-checked可能已有人在做 @hivecommons-hive 今天认领。 未关闭agent/scanner bug hive/covered-by-pr hive/hosted-available-lke648397-260827-5n31
难度 1/5 1 小时以内 新手友好度 72/100
维护者通常 1 天内回复
-
Edit: HTVKey.vn未关闭channels:edit check:passed
难度 1/5 1 小时以内 新手友好度 72/100
维护者通常 6 天内回复
-
难度 2/5 1-3 小时 新手友好度 76/100
-
beginner bug
难度 1/5 1 小时以内 新手友好度 88/100
hiero-ledger/hiero-sdk-js#4517 ·
维护者通常 1 天内回复
-
`timer` rule rejects dates the engine accepts可能已有人在做 @MFA-G 今天认领。 未关闭bug ready
难度 2/5 1-3 小时 新手友好度 72/100
camunda/bpmnlint-plugin-camunda-compat#281 · 3 条评论 ·
维护者通常 1 天内回复