{"id":1263,"date":"2026-03-12T08:57:56","date_gmt":"2026-03-12T11:57:56","guid":{"rendered":"https:\/\/maurobernal.com.ar\/blog\/?p=1263"},"modified":"2026-03-12T08:57:56","modified_gmt":"2026-03-12T11:57:56","slug":"migracion-dotnet8-dotnet10-guia-practica-produccion","status":"publish","type":"post","link":"https:\/\/maurobernal.com.ar\/blog\/migracion-dotnet8-dotnet10-guia-practica-produccion\/","title":{"rendered":"Gu\u00eda pr\u00e1ctica: c\u00f3mo migr\u00e9 mis proyectos de .NET 8 a .NET 10 sin romper producci\u00f3n"},"content":{"rendered":"\n

Migrar un proyecto de .NET 8 a .NET 10 es el tipo de tarea que parece riesgosa pero en la pr\u00e1ctica es incremental y reversible. Lo hice en varios proyectos de producci\u00f3n sin downtime. El proceso siempre es el mismo: actualizar el TFM, correr los tests, adoptar las nuevas features de a poco.<\/p>\n\n\n\n

Paso 1: Actualizar el Target Framework<\/h2>\n\n\n\n
# Verificar SDK instalado\ndotnet --list-sdks\n\n# Instalar .NET 10 SDK si no est\u00e1\n# Linux\/WSL:\nwget https:\/\/dot.net\/v1\/dotnet-install.sh -O dotnet-install.sh\nbash dotnet-install.sh --channel 10.0\n\n# En cada .csproj de la soluci\u00f3n:\n# <TargetFramework>net10.0<\/TargetFramework>\n\n# Para actualizar todos los .csproj de una soluci\u00f3n en Linux:\nfind . -name \"*.csproj\" -exec sed -i 's\/net8.0\/net10.0\/g; s\/net9.0\/net10.0\/g' {} \\;\n\n# Restaurar y compilar\ndotnet restore\ndotnet build<\/code><\/pre>\n\n\n\n
Paso 2: Actualizar paquetes NuGet<\/h2>\n\n\n\n
# Ver paquetes desactualizados\ndotnet list package --outdated\n\n# Actualizar todos los paquetes de Microsoft.* a versiones compatibles con .NET 10\ndotnet add package Microsoft.AspNetCore.OpenApi\ndotnet add package Microsoft.Extensions.Http.Resilience\n\n# Paquetes que pueden desinstalarse en .NET 10:\n# - Swashbuckle.AspNetCore (reemplazado por OpenAPI nativo)\n# - Microsoft.AspNetCore.Mvc.NewtonsoftJson (System.Text.Json mejorado)\n\n# Remover Swashbuckle si usabas OpenAPI:\ndotnet remove package Swashbuckle.AspNetCore<\/code><\/pre>\n\n\n\n
Paso 3: Adoptar las nuevas features de C# 14<\/h2>\n\n\n\n
No hay que cambiar nada para que el proyecto compile. Las nuevas features son opt-in. La estrategia es adoptarlas gradualmente donde aporten m\u00e1s valor.<\/p>\n\n\n\n
\/\/ Prioridad 1: field \u2014 m\u00e1ximo impacto con m\u00ednimo riesgo\n\/\/ Buscar propiedades con backing fields privados y migrarlas\n\n\/\/ Antes:\nprivate string _nombre = string.Empty;\npublic string Nombre\n{\n    get => _nombre;\n    set => _nombre = value?.Trim() ?? throw new ArgumentNullException();\n}\n\n\/\/ Despu\u00e9s:\npublic string Nombre\n{\n    get => field;\n    set => field = value?.Trim() ?? throw new ArgumentNullException();\n}\n\n\/\/ Prioridad 2: Primary Constructors en servicios con DI\n\/\/ Especialmente \u00fatil en proyectos con muchos servicios inyectados\n\n\/\/ Prioridad 3: params ReadOnlySpan en m\u00e9todos vari\u00e1dicos de uso frecuente\n\/\/ Buscar: params int[], params string[], params object[]\n\/\/ Reemplazar por: params ReadOnlySpan<T> donde sea posible\n\n\/\/ Prioridad 4: Lock para thread safety\n\/\/ Buscar: private readonly object _lockObj = new object();\n\/\/ Reemplazar por: private readonly Lock _lockObj = new();<\/code><\/pre>\n\n\n\n
Paso 4: Migrar a OpenAPI nativo (si usabas Swashbuckle)<\/h2>\n\n\n\n
\/\/ Program.cs \u2014 reemplazar Swashbuckle por OpenAPI nativo\n\n\/\/ ❌ Antes con Swashbuckle:\n\/\/ builder.Services.AddSwaggerGen(c => { c.SwaggerDoc(\"v1\", ...); });\n\/\/ app.UseSwagger();\n\/\/ app.UseSwaggerUI();\n\n\/\/ ✅ .NET 9\/10 nativo:\nbuilder.Services.AddOpenApi(options =>\n{\n    options.AddDocumentTransformer((document, context, ct) =>\n    {\n        document.Info = new()\n        {\n            Title = \"Mi API\",\n            Version = \"v1\",\n            Description = \"API de gesti\u00f3n interna\"\n        };\n        return Task.CompletedTask;\n    });\n});\n\n\/\/ En el pipeline:\nif (app.Environment.IsDevelopment())\n{\n    app.MapOpenApi();\n    \/\/ Opcional: seguir usando Swagger UI solo para dev\n    app.UseSwaggerUI(options =>\n        options.SwaggerEndpoint(\"\/openapi\/v1.json\", \"Mi API v1\"));\n}<\/code><\/pre>\n\n\n\n
Checklist de migraci\u00f3n completo<\/h2>\n\n\n\n
\n
Paso<\/th>Acci\u00f3n<\/th>Impacto<\/th><\/tr><\/thead>
1<\/td>Cambiar TFM a net10.0<\/code> en todos los .csproj<\/td>Obligatorio<\/td><\/tr>\n
2<\/td>dotnet restore && dotnet build<\/code><\/td>Obligatorio<\/td><\/tr>\n
3<\/td>Ejecutar suite de tests completa<\/td>Obligatorio<\/td><\/tr>\n
4<\/td>Actualizar paquetes Microsoft.* a versi\u00f3n 10.x<\/td>Recomendado<\/td><\/tr>\n
5<\/td>Adoptar field<\/code> en propiedades con backing field<\/td>Gradual<\/td><\/tr>\n
6<\/td>Primary Constructors en servicios con DI<\/td>Gradual<\/td><\/tr>\n
7<\/td>Reemplazar object _lock<\/code> por Lock _lock<\/code><\/td>Gradual<\/td><\/tr>\n
8<\/td>Migrar OpenAPI de Swashbuckle a nativo<\/td>Opcional<\/td><\/tr>\n
9<\/td>Adoptar params ReadOnlySpan<T><\/code> en hot paths<\/td>Opcional<\/td><\/tr>\n
10<\/td>Evaluar Native AOT para Workers\/APIs simples<\/td>Opcional avanzado<\/td><\/tr>\n<\/tbody><\/table><\/figure>\n\n\n\n
Errores comunes y c\u00f3mo resolverlos<\/h2>\n\n\n\n
\/\/ ERROR 1: Paquete no compatible con net10.0\n\/\/ \"Package X is not compatible with net10.0\"\n\/\/ Soluci\u00f3n: actualizar a la versi\u00f3n m\u00e1s reciente del paquete\n\/\/ Si no hay versi\u00f3n compatible, usar <TargetFrameworks>net8.0;net10.0<\/TargetFrameworks>\n\n\/\/ ERROR 2: Reflection en Native AOT\n\/\/ \"System.InvalidOperationException: Type ... is not reflection-enabled\"\n\/\/ Soluci\u00f3n: agregar source generator o usar [DynamicDependency]\n[DynamicDependency(DynamicallyAccessedMemberTypes.All, typeof(MiClase))]\nstatic void MetodoConReflection() { ... }\n\n\/\/ ERROR 3: field en C# 14 \u2014 feature no disponible\n\/\/ \"error CS8652: The feature 'field keyword' is currently in Preview\"\n\/\/ Soluci\u00f3n: habilitar preview features en .csproj\n\/\/ <LangVersion>preview<\/LangVersion>\n\/\/ (o esperar a que salga de preview en la versi\u00f3n final de .NET 10)\n\n\/\/ ERROR 4: Cambios breaking en serializaci\u00f3n JSON\n\/\/ System.Text.Json en .NET 10 es m\u00e1s estricto con algunos tipos\n\/\/ Soluci\u00f3n: revisar JsonSerializerOptions y ajustar si es necesario<\/code><\/pre>\n\n\n\n
Mi experiencia: cu\u00e1nto tard\u00f3 cada proyecto<\/h2>\n\n\n\n