Skip to content

Commit 9cf47fd

Browse files
Copilotgewarren
andcommitted
Add breaking change documentation for NUGET_ENABLE_ENHANCED_HTTP_RETRY removal
Co-authored-by: gewarren <[email protected]>
1 parent cdee723 commit 9cf47fd

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
@@ -79,6 +79,7 @@ If you're migrating an app to .NET 10, the breaking changes listed here might af
7979
| [MSBuild custom culture resource handling](sdk/10.0/msbuild-custom-culture.md) | Behavioral change | Preview 1 |
8080
| [NU1510 is raised for direct references pruned by NuGet](sdk/10.0/nu1510-pruned-references.md) | Source incompatible | Preview 1 |
8181
| [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 |
82+
| [NUGET_ENABLE_ENHANCED_HTTP_RETRY environment variable removed](sdk/10.0/nuget-enhanced-http-retry-removed.md) | Behavioral change | Preview 6 |
8283

8384
## Windows Forms
8485

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: 12/23/2024
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 would use 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 would overwhelm 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. The exponential retry behavior is more resilient and should provide better performance in most scenarios.
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
@@ -76,6 +76,8 @@ items:
7676
href: sdk/10.0/nu1510-pruned-references.md
7777
- name: HTTP warnings promoted to errors in package list and search
7878
href: sdk/10.0/http-warnings-to-errors.md
79+
- name: NUGET_ENABLE_ENHANCED_HTTP_RETRY environment variable removed
80+
href: sdk/10.0/nuget-enhanced-http-retry-removed.md
7981
- name: Windows Forms
8082
items:
8183
- name: API obsoletions

0 commit comments

Comments
 (0)