diff --git a/docs/core/compatibility/10.0.md b/docs/core/compatibility/10.0.md index a3969d610efc7..5ec535f28e6e6 100644 --- a/docs/core/compatibility/10.0.md +++ b/docs/core/compatibility/10.0.md @@ -79,6 +79,7 @@ If you're migrating an app to .NET 10, the breaking changes listed here might af | [MSBuild custom culture resource handling](sdk/10.0/msbuild-custom-culture.md) | Behavioral change | Preview 1 | | [NU1510 is raised for direct references pruned by NuGet](sdk/10.0/nu1510-pruned-references.md) | Source incompatible | Preview 1 | | [HTTP warnings promoted to errors in `dotnet package list` and `dotnet package search`](sdk/10.0/http-warnings-to-errors.md) | Behavioral/source incompatible change | Preview 4 | +| [NUGET_ENABLE_ENHANCED_HTTP_RETRY environment variable removed](sdk/10.0/nuget-enhanced-http-retry-removed.md) | Behavioral change | Preview 6 | ## Windows Forms diff --git a/docs/core/compatibility/sdk/10.0/nuget-enhanced-http-retry-removed.md b/docs/core/compatibility/sdk/10.0/nuget-enhanced-http-retry-removed.md new file mode 100644 index 0000000000000..452f90a00b9c2 --- /dev/null +++ b/docs/core/compatibility/sdk/10.0/nuget-enhanced-http-retry-removed.md @@ -0,0 +1,38 @@ +--- +title: "Breaking change: NUGET_ENABLE_ENHANCED_HTTP_RETRY environment variable removed" +description: "Learn about the breaking change in .NET 10 where NUGET_ENABLE_ENHANCED_HTTP_RETRY environment variable no longer disables exponential retry." +ms.date: 06/24/2025 +ai-usage: ai-assisted +ms.custom: https://github.com/dotnet/docs/issues/46537 +--- +# NUGET_ENABLE_ENHANCED_HTTP_RETRY environment variable removed + +The `NUGET_ENABLE_ENHANCED_HTTP_RETRY` environment variable no longer has any effect in .NET 10. Previously, this environment variable could be used to disable exponential retry back-off for failed HTTP calls in NuGet operations. + +## Version introduced + +.NET 10 Preview 6 + +## Previous behavior + +When the `NUGET_ENABLE_ENHANCED_HTTP_RETRY` environment variable was set to `false`, NuGet used the old retry behavior with a fixed 200ms delay between failed HTTP calls instead of exponential back-off. + +## New behavior + +The `NUGET_ENABLE_ENHANCED_HTTP_RETRY` environment variable has no effect. NuGet always uses exponential retry back-off for failed HTTP calls, which has been the default behavior since .NET SDK 6.0.300. + +## Type of breaking change + +This is a [behavioral change](../../categories.md#behavioral-change). + +## Reason for change + +Exponential retry back-off has been the default behavior for nearly 4 years since .NET SDK 6.0.300. The feature was introduced to help when restores overwhelmed servers that couldn't handle all package requests, and exponential retry allowed these requests to succeed. Since there has been no feedback indicating issues with this approach, the fallback option has outlived its utility. + +## Recommended action + +No action is required. + +## Affected APIs + +None. diff --git a/docs/core/compatibility/toc.yml b/docs/core/compatibility/toc.yml index bd8dd49dadfdc..e818deab9dcac 100644 --- a/docs/core/compatibility/toc.yml +++ b/docs/core/compatibility/toc.yml @@ -76,6 +76,8 @@ items: href: sdk/10.0/nu1510-pruned-references.md - name: HTTP warnings promoted to errors in package list and search href: sdk/10.0/http-warnings-to-errors.md + - name: NUGET_ENABLE_ENHANCED_HTTP_RETRY environment variable removed + href: sdk/10.0/nuget-enhanced-http-retry-removed.md - name: Windows Forms items: - name: API obsoletions