Skip to content

Commit ae9374d

Browse files
Copilotgewarren
andauthored
Add breaking change documentation for NUGET_ENABLE_ENHANCED_HTTP_RETRY removal (#46927)
* Initial plan * Add breaking change documentation for NUGET_ENABLE_ENHANCED_HTTP_RETRY removal Co-authored-by: gewarren <[email protected]> * human edits --------- Co-authored-by: copilot-swe-agent[bot] <[email protected]> Co-authored-by: gewarren <[email protected]>
1 parent 852e318 commit ae9374d

File tree

3 files changed

+41
-0
lines changed

3 files changed

+41
-0
lines changed

docs/core/compatibility/10.0.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -82,6 +82,7 @@ If you're migrating an app to .NET 10, the breaking changes listed here might af
8282
| [NU1510 is raised for direct references pruned by NuGet](sdk/10.0/nu1510-pruned-references.md) | Source incompatible | Preview 1 |
8383
| [PackageReference without a version raises an error](sdk/10.0/nu1015-packagereference-version.md) | Behavioral change | Preview 6 |
8484
| [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 |
85+
| [NUGET_ENABLE_ENHANCED_HTTP_RETRY environment variable removed](sdk/10.0/nuget-enhanced-http-retry-removed.md) | Behavioral change | Preview 6 |
8586

8687
## Windows Forms
8788

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
---
2+
title: "Breaking change: NUGET_ENABLE_ENHANCED_HTTP_RETRY environment variable removed"
3+
description: "Learn about the breaking change in .NET 10 where NUGET_ENABLE_ENHANCED_HTTP_RETRY environment variable no longer disables exponential retry."
4+
ms.date: 06/24/2025
5+
ai-usage: ai-assisted
6+
ms.custom: https://github.com/dotnet/docs/issues/46537
7+
---
8+
# NUGET_ENABLE_ENHANCED_HTTP_RETRY environment variable removed
9+
10+
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.
11+
12+
## Version introduced
13+
14+
.NET 10 Preview 6
15+
16+
## Previous behavior
17+
18+
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.
19+
20+
## New behavior
21+
22+
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.
23+
24+
## Type of breaking change
25+
26+
This is a [behavioral change](../../categories.md#behavioral-change).
27+
28+
## Reason for change
29+
30+
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.
31+
32+
## Recommended action
33+
34+
No action is required.
35+
36+
## Affected APIs
37+
38+
None.

docs/core/compatibility/toc.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -82,6 +82,8 @@ items:
8282
href: sdk/10.0/nu1015-packagereference-version.md
8383
- name: HTTP warnings promoted to errors in package list and search
8484
href: sdk/10.0/http-warnings-to-errors.md
85+
- name: NUGET_ENABLE_ENHANCED_HTTP_RETRY environment variable removed
86+
href: sdk/10.0/nuget-enhanced-http-retry-removed.md
8587
- name: Windows Forms
8688
items:
8789
- name: API obsoletions

0 commit comments

Comments
 (0)