Microservicios en C#: por dónde empezar en 2025

Microservicios en C#: por dónde empezar para principiantes en 2025

Antes parecía que los microservicios eran cosa de gigantes como Netflix o Amazon. Pero los tiempos han cambiado. Hoy en día, la arquitectura de microservicios en C# está al alcance de cualquier desarrollador que quiera construir sistemas flexibles, escalables y mantenibles. Si sientes que el monolito está "asfixiando" tu proyecto, o simplemente quieres aprender una habilidad demandada, has llegado al lugar indicado.

En este artículo analizaremos: por dónde empezar, qué tecnologías elegir y escribiremos dos microservicios reales en C# desde cero. Sin rodeos, solo práctica.

Por qué C# es una excelente opción para microservicios

C# y el ecosistema .NET no son solo un lenguaje, sino un framework completo para construir sistemas distribuidos. Estas son las razones por las que muchos eligen microservicios en C#:

\n
• ASP.NET Core — ligero, multiplataforma y de alto rendimiento. Funciona en Windows, Linux y macOS.
\n
• Soporte integrado para Docker — Visual Studio puede agregar soporte Docker a un proyecto con dos clics.
\n
• gRPC y SignalR — soluciones listas para la comunicación entre servicios y en tiempo real.
\n
• Entity Framework Core — un ORM conveniente que se configura fácilmente para bases de datos de microservicios.
\n
• Gran comunidad — en Stack Overflow y GitHub hay miles de soluciones listas.
\n

Por cierto, si recién estás comenzando con C#, te recomiendo echar un vistazo a la sección de artículos básicos en PythonLib — allí hay mucho contenido útil para empezar.

Por dónde empezar: estructura del proyecto

El error de un principiante es lanzarse a escribir código sin haber planificado la arquitectura. Hagámoslo bien. Primero, crearemos dos microservicios:

\n
• UserService — se encarga de los usuarios (registro, perfil).
\n
• OrderService — se encarga de los pedidos.
\n

Cada servicio tendrá su propia base de datos (SQLite para simplificar) y se comunicarán a través de REST API. Para empezar, esto es suficiente.

Paso 1. Creamos el proyecto UserService

Abre la terminal o Visual Studio y ejecuta:

dotnet new webapi -n UserService\ncd UserService\ndotnet add package Microsoft.EntityFrameworkCore.Sqlite\ndotnet add package Microsoft.EntityFrameworkCore.Design

La estructura del proyecto se verá así:

UserService/\n├── Controllers/\n│   └── UsersController.cs\n├── Models/\n│   └── User.cs\n├── Data/\n│   └── AppDbContext.cs\n├── Program.cs\n└── appsettings.json

Paso 2. Modelo y contexto de datos

Creamos el modelo de usuario:

// Models/User.cs\npublic class User\n{\n    public int Id { get; set; }\n    public string Name { get; set; } = string.Empty;\n    public string Email { get; set; } = string.Empty;\n    public DateTime CreatedAt { get; set; } = DateTime.UtcNow;\n}

Y el contexto de la base de datos:

// Data/AppDbContext.cs\nusing Microsoft.EntityFrameworkCore;\n\npublic class AppDbContext : DbContext\n{\n    public AppDbContext(DbContextOptions<AppDbContext> options) : base(options) { }\n    public DbSet<User> Users { get; set; }\n}

Configuramos la conexión en appsettings.json:

{\n  "ConnectionStrings": {\n    "DefaultConnection": "Data Source=users.db"\n  },\n  "Logging": {\n    "LogLevel": { "Default": "Information" }\n  }\n}

Registramos los servicios en Program.cs:

var builder = WebApplication.CreateBuilder(args);\n\nbuilder.Services.AddDbContext<AppDbContext>(options =>\n    options.UseSqlite(builder.Configuration.GetConnectionString("DefaultConnection")));\n\nbuilder.Services.AddControllers();\nbuilder.Services.AddEndpointsApiExplorer();\nbuilder.Services.AddSwaggerGen();\n\nvar app = builder.Build();\n\n// Auto