IllegalArgumentException: "Invalid ref..." when uses an external link like "../demo#/components"

未关闭

#810 创建于 2025年8月11日 2 条评论 1 个 reaction 已指派 0 人在 GitHub 查看

还没有人认领这个 Issue。

评估

难度: 3/5
预计耗时: 1-2 天
新手友好度: 35/100

Issue 类型: 缺陷
描述清晰度: 需要澄清
活跃度: 停滞
技术栈: java, openapi
领域: api

调研方向

从 org.openapitools.openapidiff.core.utils.RefPointer.java 的 getRefName 开始，然后跟踪 stack trace 中显示的 resolveRef 和 SchemaDiff.computeDiffForReal 调用。使用类似 ../../common/restapi-sdk-data-schemas.yaml#/components/schemas/ApiError 的外部引用重现比较，并确定对该引用的预期处理方式，且不要引发 Invalid ref。

由索引模型根据 Issue 内容生成。

描述

Hello, thinks for the nice tools, but i faced a problem where when i uses an external link, an exception was thrown
Exception in thread "main" java.lang.IllegalArgumentException: Invalid ref: ../../common/restapi-sdk-data-schemas.yaml#/components/schemas/ApiError at org.openapitools.openapidiff.core.utils.RefPointer.getRefName(RefPointer.java:60) at org.openapitools.openapidiff.core.utils.RefPointer.resolveRef(RefPointer.java:16) at org.openapitools.openapidiff.core.compare.SchemaDiff.computeDiffForReal(SchemaDiff.java:340) at org.openapitools.openapidiff.core.model.deferred.DeferredSchemaCache.processSchemaQueue(DeferredSchemaCache.java:86) at org.openapitools.openapidiff.core.model.deferred.DeferredSchemaCache.process(DeferredSchemaCache.java:64) at org.openapitools.openapidiff.core.compare.OpenApiDiff.compare(OpenApiDiff.java:113) at org.openapitools.openapidiff.core.compare.OpenApiDiff.compare(OpenApiDiff.java:72) at org.openapitools.openapidiff.core.OpenApiCompare.fromSpecifications(OpenApiCompare.java:166) at org.openapitools.openapidiff.core.OpenApiCompare.fromSpecifications(OpenApiCompare.java:153)

After read sourcecode, i think i have no any way to trun off the checks on ref

主要语言: Java
星标: 1.1k
派生: 190
PR 合并指标: 30 天内没有已合并 PR

贡献指南

打开贡献指南

从这里开始

先读完整个 Issue，再读项目的贡献指南。
在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
Fork 仓库，在一个分支上完成修改。
提交 Pull Request，并在描述里引用这个 Issue 编号。

OpenAPITools/openapi-diff 的其他 Issue

In openapi-diff-cli add old and new filenames to the output 未关闭

enhancement

难度 2/5 1-3 小时新手友好度 68/100

OpenAPITools/openapi-diff#506 · 2023年4月4日创建
HtmlRender: Notes of Parameters shows always the new description 未关闭

good first issue help wanted

难度 2/5 1-3 小时新手友好度 68/100

OpenAPITools/openapi-diff#364 · 2022年4月5日创建
Property `type` change on referenced component schema is silently ignored 未关闭

bug OpenAP 3.1.0 Support

难度 3/5 1-2 天新手友好度 68/100

OpenAPITools/openapi-diff#910 · 1 条评论 · 2026年6月12日创建
Changes reported in operations but only securityScheme changed 未关闭

Render capabilities

难度 3/5 1-2 天新手友好度 55/100

OpenAPITools/openapi-diff#893 · 1 条评论 · 2026年2月25日创建
[Bug] Backward compatibility check fails on reordered discriminator mappings 未关闭

Breaking/Non-Breaking classification

难度 3/5 1-2 天新手友好度 55/100

OpenAPITools/openapi-diff#886 · 2026年1月30日创建

查看 OpenAPITools/openapi-diff 的全部 Issue

相似的 Issue

build-scan-xunit: accept ISO offset timestamps in test reports 未关闭

难度 2/5 1-3 小时新手友好度 75/100

elastic/gradle-plugins#157 · 2026年9月23日创建
Counterexamples differ when using `-recover` (`-workers`, `-fp`, `-seed` must match the original run) 未关闭

enhancement Tools

难度 1/5 1 小时以内新手友好度 75/100

tlaplus/tlaplus#1444 · 2 条评论 · 2026年9月23日创建
[Studio][Bug] rmq.instance.metrics advertises an invalid MCP input contract 未关闭

难度 2/5 1-3 小时新手友好度 70/100

apache/rocketmq-dashboard#5008 · 2026年9月23日创建
[Bug] A cell read into a ReadCellData field loses its row and column index 未关闭

bug

难度 2/5 1-3 小时新手友好度 75/100

apache/fesod#1131 · 1 条评论 · 2026年9月23日创建
DETECT_PARAMETER_NAMES=false silently disables @ConstructorProperties-based Creator detection too 未关闭

难度 2/5 1-3 小时新手友好度 70/100

FasterXML/jackson-databind#6229 · 2026年9月23日创建

更多 Java Issue