Fail while uploading Microsoft.EntityFrameworkCore.Analyzers to local BaGet server

[CryingMisu]

When trying to upload a package "Microsoft.EntityFrameworkCore.Analyzers" to BaGet server using command
nuget.exe push Microsoft.EntityFrameworkCore.Analyzers.nupkg -ApiKey <apiKey> -Source <source> -SkipDuplicate

, the server returns a 402 error. The server logs say:

fail: BaGet.Core.PackageIndexingService[0]
Uploaded package is invalid
System.IO.FileNotFoundException: docs\PACKAGE.md
at Nuget.Packaging.ZipArchiveExtensions.LookupEntry(ZipArchive zipArchive, String path)
at Nuget.Packaging.PackageArchiveReader.GetStream(String path)
at Nuget.Packaging.PackageReaderBase.GetStreamAsync(String path, CancellationToken cancellationToken)
at BaGet.Core.PackageArchiveReaderExtensions.GetReadmeAsync(PackageArchiveReader package, CancellationToken cancellationToken) in /src/BaGet.Core/Extensions/PackageArchiveReaderExtensions.cs: line 33
at BaGet.Core.PackageIndexingService.IndexAsync(Stream packageStream, CancellationToken cancellationToken) in /src/BaGet.Core/Indexing/PackageIndexingService.cs: line 163

[Microsoft.EntityFrameworkCore.Analyzers version 8.0.20]

[cincuranet]

Downloaded nupkg (renamed to zip) from NuGet:

unzip -l /mnt/d/Downloads/microsoft.entityframeworkcore.analyzers.10.0.0-rc.2.25502.107.zip
Archive:  /mnt/d/Downloads/microsoft.entityframeworkcore.analyzers.10.0.0-rc.2.25502.107.zip
  Length      Date    Time    Name
---------  ---------- -----   ----
      533  2025-10-02 21:32   _rels/.rels
     1135  2025-10-02 21:32   Microsoft.EntityFrameworkCore.Analyzers.nuspec
     1050  2025-10-02 19:19   Icon.png
      808  2025-10-02 19:19   docs/PACKAGE.md
    43040  2025-10-02 21:29   analyzers/dotnet/cs/Microsoft.EntityFrameworkCore.Analyzers.dll
      590  2025-10-02 21:32   [Content_Types].xml
      783  2025-10-02 21:32   package/services/metadata/core-properties/90a6afacb1e944e9a80d255d414d3ed2.psmdcp
    25764  2025-10-14 10:34   .signature.p7s
---------                     -------
    73703                     8 files

Clearly the docs/PACKAGE.md is there. And NuGet was able to process that package.

Not sure how yours was build, maybe something is missing there. Can you share more info how you've created the package? BTW we have a docs for building the code.

[CryingMisu]

I downloaded this package from official site
https://www.nuget.org/api/v2/package/Microsoft.EntityFrameworkCore.Analyzers/8.0.20

I think the problem may be in the configuration file inside the package. Config file contains path to PACKAGE.md with backslash, but must be written with a slash

Example:
line in config docs\PACKAGE.md
file path in package docs/PACKAGE.md

[cincuranet]

That's an interesting point. Every Microsoft.* package I randomly checked has backslashes in nuspec. NuGet was able to process these packages.

@ViktorHofer any idea whom to ping do get some definitive answer around (back)slashes here?

[ViktorHofer]

Yeah NuGet has some issues when using \. I see that happening here:

efcore/src/EFCore.Analyzers/EFCore.Analyzers.nuspec

Line 9 in f47a6e8

<readme>docs\PACKAGE.md</readme>

Two observations:

• Replace those slashes with / and see if that resolves the issue
• These nuspec files really shouldn't be hand authored. This repository should just create nuget packages as the rest of the stack. NuGet Pack offers sufficient extension points to make all kinds of packaging layouts possible.