Swagger UI cannot resolve references in external YAML files
A valid multi-file OpenAPI document worked as one file but displayed unresolved-reference errors in Counterfact's Swagger UI.
- Report
- Issue #1244
- Reporter
- sugiruu
- Reported
- March 28, 2025
- Reported version
- Not specified
- Primary matched window
- Included
- First affected release entered primary window
- No
- Origin classification
- Pre-existing before 2025
- Classification confidence
- High
- Chronology confidence
- Medium
- Accepted correction
- PR #1553
- First fixed release
- 2.2.1
- Report to release
- 357 days
Finding
The serving path is confirmed to preserve external references well before 2025. The audit does not claim the extraction commit was the first possible occurrence.
Evidence trail
Origin
Confirmed affected by: 326d9a10, committed October 4, 2023; confirmed affected release 0.29.0. The documented OpenAPI viewer served the root document without bundling sibling-file references for the browser.
Source history and behavioral evidence
The 2023 middleware state serves the document without producing a self-contained browser payload. The accepted fix bundles external references and reproduces the multi-file report in tests.
Release chronology
The behavior is confirmed by 0.29.0 and at the 2025 report. The eventual correction shipped in 2.2.1, 357 days after the report.