Changes reported in operations but only securityScheme changed

オープン

#893 2026年2月25日に作成コメント 1 件リアクション 0 件担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度: 3/5
見積もり時間: 1〜2日
初心者へのやさしさ: 55/100

issue の種類: バグ
明瞭さ: おおむね明確
活発さ: 静か
技術スタック: java
領域: api

調査の方向性

まず、示されている2つの OpenAPI 3.1 ドキュメントと openapi-diff-core 2.1.6 依存関係を使って報告を再現します。OAuth2 securityScheme の authorizationUrl と tokenUrl への変更が POST /users にどのように割り当てられるかを追跡し、次に報告された変更箇所を更新して、結果のメッセージが security-scheme の変更を特定していることを確認します。

索引モデルが issue の本文から書いたものです。

説明

Render capabilities

I am using

    testImplementation("org.openapitools.openapidiff:openapi-diff-core:2.1.6") {
        exclude(group = "io.swagger.core.v3", module = "swagger-core")
        exclude(group = "io.swagger.core.v3", module = "swagger-models")
        exclude(group = "io.swagger.core.v3", module = "swagger-annotations")
    }

Given the two API docs to compare where the only change is in authorizationUrl ('' vs. 'some_value') and tokenUrl ('' vs. 'some_value').

First file

components:
  securitySchemes:
    OAuth2:
      bearerFormat: JWT
      flows:
        authorizationCode:
          authorizationUrl: ''
          tokenUrl: ''
      in: header
      scheme: bearer
      type: oauth2
info:
  title: Company API
  version: V0
openapi: 3.1.0
paths:
  /users:
    post:
      operationId: createUser
      responses:
        "201":
          description: Created
      security:
      - OAuth2: []
servers:
- description: Default Server URL
  url: /api/

Second file

components:
  securitySchemes:
    OAuth2:
      bearerFormat: JWT
      flows:
        authorizationCode:
          authorizationUrl: 'some_value'
          tokenUrl: 'some_value'
      in: header
      scheme: bearer
      type: oauth2
info:
  title: Company API
  version: V0
openapi: 3.1.0
paths:
  /users:
    post:
      operationId: createUser
      responses:
        "201":
          description: Created
      security:
      - OAuth2: []
servers:
- description: Default Server URL
  url: /api/

The resulting error message is misleading as the issue is not directly related to any concrete endpoint. This took me quite a while to narrow this down to this difference.

So it would be nice to have a more suitable error message.

org.opentest4j.AssertionFailedError: [### Company API (v V0)
---

#### What's Changed
---

##### `POST` /users


#### Result
---

API changes broke backward compatibility

]

主要言語: Java
スター: 1.1k
フォーク: 190
PR マージ指標: 30日以内にマージされた PR はありません

コントリビューションガイド

コントリビューションガイドを開く

はじめの一歩

issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
リポジトリをフォークし、ブランチを切って変更します。
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日に作成
[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日に作成
Feature Request: generate Overlay for the given 2 OpenAPI files オープン

難易度 5/5 1週間以上初心者へのやさしさ 25/100

OpenAPITools/openapi-diff#883 · 2026年1月20日に作成

OpenAPITools/openapi-diff の issue をすべて見る

似ている issue

[Bug][UI] Change the method of opening the Action Detail オープン

難易度 2/5 1〜3時間初心者へのやさしさ 65/100

Netcracker/qubership-integration-platform#913 · 2026年9月23日に作成
SEC-CORS-006 declares MEDIUM but can only emit HIGH or LOW オープン

bug

難易度 2/5 1〜3時間初心者へのやさしさ 75/100

jdubois/boot-ui#1100 · 2026年9月23日に作成
build-scan-xunit: accept ISO offset timestamps in test reports オープン

難易度 2/5 1〜3時間初心者へのやさしさ 75/100

elastic/gradle-plugins#157 · 2026年9月23日に作成
OpenAPI document marks optional request body of `PUT /api/users/me` as required オープン

難易度 2/5 1〜3時間初心者へのやさしさ 75/100

cryptomator/hub#497 · 2026年9月23日に作成
No test covers the claim that only the last command's state is checked オープン

難易度 2/5 1〜3時間初心者へのやさしさ 75/100

johanhaleby/occurrent#1120 · 2026年9月23日に作成

Java の issue をもっと見る