2025年C#微服务入门指南

2025年C#微服务新手入门指南

过去，微服务似乎是Netflix或Amazon等巨头的专利。但时代已经变了。如今，C#微服务架构对每一位希望构建灵活、可扩展且易于维护系统的开发者来说都已触手可及。如果你觉得单体架构正在“扼杀”你的项目，或者只是想掌握一项热门技能，那么你来对地方了。

在本文中，我们将探讨：从何入手、选择哪些技术，并从零开始编写两个真实的C#微服务。全是干货，只有实践。

为什么C#是微服务的绝佳选择

C#和.NET生态系统不仅仅是一种语言，更是一个用于构建分布式系统的完整框架。以下是许多人选择C#微服务的原因：

\n
• ASP.NET Core — 轻量、跨平台且高性能。支持Windows、Linux、macOS。
\n
• 内置Docker支持 — Visual Studio只需点击两下即可为项目添加Docker支持。
\n
• gRPC和SignalR — 现成的服务间通信和实时通信解决方案。
\n
• Entity Framework Core — 便捷的ORM，易于配置用于微服务数据库。
\n
• 庞大的社区 — Stack Overflow和GitHub上有成千上万的现成解决方案。
\n

顺便提一下，如果你刚开始学习C#，建议看看PythonLib上的基础文章——那里有很多对入门有帮助的内容。

从何入手：项目结构

新手常犯的错误是直接开始写代码，而不先考虑架构。让我们正确地进行。首先，创建两个微服务：

\n
• UserService — 负责用户管理（注册、个人资料）。
\n
• OrderService — 负责订单管理。
\n

每个服务都将拥有自己的数据库（为简单起见使用SQLite），并通过REST API进行通信。对于入门来说，这已经足够了。

步骤1. 创建UserService项目

打开终端或Visual Studio，执行以下命令：

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

项目结构将如下所示：

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

步骤2. 模型和数据上下文

创建用户模型：

// 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}

以及数据库上下文：

// 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}

在appsettings.json中配置连接：

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

在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// 自动