AsyncAPI.NET isn't able to load external file

Describe the bug

When I set the ReferenceResolution as ReferenceResolutionSetting.ResolveAllReferences and the message payload is referencing an external file, that file is not loaded

To Reproduce

Having an AsyncAPI V3 where the message payload is an external file and mark to resolve all references

var path = Path.Combine(Environment.CurrentDirectory, "V3_TestData", "AsyncApiSchema_MessageInDiffFile.yml");
var reader = new AsyncApiStreamReader(new AsyncApiReaderSettings
{
    ReferenceResolution = ReferenceResolutionSetting.ResolveAllReferences,
});

var doc = reader.Read(File.OpenRead(path), out var diag);
Assert.IsEmpty(diag.Errors);

Error:

Something went wrong trying to fetch './AsyncApiSchema_MessagePayload.yml. Could not find file '<READACT>\AsyncAPI.NET\test\ByteBard.AsyncAPI.Tests\bin\Debug\net8.0\AsyncApiSchema_MessagePayload.yml'.'

Expected behaviour

The diagnostic should be empty

Sample document

Async file:

asyncapi: 3.0.0

info:
  title: Streetlights Kafka API
  version: 1.0.0
  description: The Smartylighting Streetlights API allows you to remotely manage the city lights.
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0

channels:
  mychannel:
    messages:
      whatever:
        payload:
          $ref: "./AsyncApiSchema_MessagePayload.yml"

Payload file:

type: object
required:
  - testB
properties:
  testC:
    type: object
    properties:
      testD:
        type: string
        format: uuid
  testB:
    type: boolean
    description: test

Welcome to AsyncAPI.NET. Thank you for reporting your first issue. Please check out our contributors guide.

Oh snap! I'll look into it when I get back near a pc. Thanks you for reporting this.

I was wrong in my first assumption. you never hit the switch case. the uri is relative, and thus throws on the .Scheme call in the switch. I've added a PR to fix it.

Would you like the ability to provide a baseUri for relative uris to be resolved against? or just resolve against the current working dir?

fixed as of 2.1.2 (beta release here https://www.nuget.org/packages/ByteBard.AsyncAPI.NET/)

Navigation Menu

Repository navigation

AsyncAPI.NET isn't able to load external file #20

Describe the bug

To Reproduce

Expected behaviour

Sample document

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

AsyncAPI.NET isn't able to load external file #20

Description

Describe the bug

To Reproduce

Expected behaviour

Sample document

Activity

github-actions commented on Oct 24, 2025

VisualBean commented on Oct 24, 2025

VisualBean commented on Oct 24, 2025

VisualBean commented on Oct 25, 2025

VisualBean commented on Dec 7, 2025

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions