{"id":289,"date":"2026-07-07T08:22:32","date_gmt":"2026-07-07T00:22:32","guid":{"rendered":"https:\/\/www.erwa.cn\/?p=289"},"modified":"2026-07-07T08:22:34","modified_gmt":"2026-07-07T00:22:34","slug":"asp-net-core-net8-cleanarchitecture-%e4%ba%a7%e5%93%81%e7%ba%a7%e5%ae%8c%e6%95%b4%e9%a1%b9%e7%9b%ae%e6%a8%a1%e6%9d%bf","status":"publish","type":"post","link":"https:\/\/www.erwa.cn\/index.php\/2026\/07\/07\/asp-net-core-net8-cleanarchitecture-%e4%ba%a7%e5%93%81%e7%ba%a7%e5%ae%8c%e6%95%b4%e9%a1%b9%e7%9b%ae%e6%a8%a1%e6%9d%bf\/","title":{"rendered":"ASP.NET Core .NET8 CleanArchitecture \u4ea7\u54c1\u7ea7\u5b8c\u6574\u9879\u76ee\u6a21\u677f"},"content":{"rendered":"\n<h2 class=\"wp-block-heading\">\u4e00\u3001\u89e3\u51b3\u65b9\u6848\u5206\u5c42\u7ed3\u6784\uff08\u5927\u5382\u6807\u51c6 4 \u5c42\u6d0b\u8471\u67b6\u6784\uff09<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">plaintext<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code><code>YourProject.sln\n\u251c\u2500 YourProject.Domain                # \u9886\u57df\u5c42\uff08\u65e0\u4efb\u4f55\u7b2c\u4e09\u65b9\u57fa\u7840\u8bbe\u65bd\u4f9d\u8d56\uff09\n\u251c\u2500 YourProject.Application           # \u5e94\u7528\u5c42\uff08\u4e1a\u52a1\u7528\u4f8b\u3001CQRS\u3001DTO\u3001\u62bd\u8c61\u4ed3\u50a8\uff09\n\u251c\u2500 YourProject.Infrastructure        # \u57fa\u7840\u8bbe\u65bd\uff08EF\u3001Redis\u3001\u7b2c\u4e09\u65b9SDK\u3001\u4ed3\u50a8\u5b9e\u73b0\uff09\n\u2514\u2500 YourProject.Api                   # \u8868\u793a\u5c42 WebAPI\uff08\u63a7\u5236\u5668\u3001\u9274\u6743\u3001\u4e2d\u95f4\u4ef6\u3001Swagger\uff09\n<\/code><\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\">\u4e8c\u3001\u6bcf\u5c42\u5b8c\u6574\u4ee3\u7801\u9aa8\u67b6\uff08\u53ef\u76f4\u63a5\u590d\u5236\u65b0\u5efa\u7c7b\u5e93\uff09<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">1. \u9886\u57df\u5c42 YourProject.Domain<\/h3>\n\n\n\n<h4 class=\"wp-block-heading\">\u9879\u76ee\u5f15\u7528<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">\u4ec5\u5f15\u7528 <code>Microsoft.Extensions.DependencyInjection.Abstractions<\/code>\uff0c<strong>\u7981\u6b62\u5f15\u7528 EF\u3001Redis\u3001Api \u7b49<\/strong><\/p>\n\n\n\n<h4 class=\"wp-block-heading\">\u76ee\u5f55\u7ed3\u6784<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">plaintext<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code><code>Domain\n\u251c\u2500 Entities         # \u6570\u636e\u5e93\u5b9e\u4f53\n\u251c\u2500 ValueObjects     # \u503c\u5bf9\u8c61\uff08DDD\uff09\n\u251c\u2500 Events           # \u9886\u57df\u4e8b\u4ef6\n\u251c\u2500 Interfaces       # \u4ed3\u50a8\u62bd\u8c61\u3001\u9886\u57df\u670d\u52a1\u63a5\u53e3\n\u2514\u2500 Exceptions       # \u81ea\u5b9a\u4e49\u4e1a\u52a1\u5f02\u5e38<\/code>\n<\/code><\/pre>\n\n\n\n<h5 class=\"wp-block-heading\">1.1 \u9886\u57df\u5b9e\u4f53\u793a\u4f8b Entities\/User.cs<\/h5>\n\n\n\n<p class=\"wp-block-paragraph\">csharp<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\u8fd0\u884c<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code><code>namespace YourProject.Domain.Entities;\n\npublic class User\n{\n    public long Id { get; set; }\n    public string UserName { get; set; } = string.Empty;\n    public string PasswordHash { get; set; } = string.Empty;\n    public string Phone { get; set; } = string.Empty;\n    public DateTime CreateTime { get; set; }\n    public bool IsDeleted { get; set; }\n}<\/code>\n<\/code><\/pre>\n\n\n\n<h5 class=\"wp-block-heading\">1.2 \u4ed3\u50a8\u62bd\u8c61\u63a5\u53e3 Interfaces\/IUserRepository.cs<\/h5>\n\n\n\n<p class=\"wp-block-paragraph\">csharp<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\u8fd0\u884c<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code><code>using YourProject.Domain.Entities;\n\nnamespace YourProject.Domain.Interfaces;\n\npublic interface IUserRepository\n{\n    Task&lt;User?> GetByIdAsync(long id, CancellationToken ct = default);\n    Task AddAsync(User user, CancellationToken ct = default);\n    Task UpdateAsync(User user, CancellationToken ct = default);\n    Task DeleteAsync(User user, CancellationToken ct = default);\n    Task&lt;User?> GetByNameAsync(string userName, CancellationToken ct = default);\n}\n<\/code><\/code><\/pre>\n\n\n\n<h5 class=\"wp-block-heading\">1.3 \u4e1a\u52a1\u81ea\u5b9a\u4e49\u5f02\u5e38 Exceptions\/BusinessException.cs<\/h5>\n\n\n\n<p class=\"wp-block-paragraph\">csharp<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\u8fd0\u884c<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code><code>namespace YourProject.Domain.Exceptions;\n\npublic class BusinessException : Exception\n{\n    public int Code { get; }\n    public BusinessException(int code, string message) : base(message)\n    {\n        Code = code;\n    }\n}\n<\/code><\/code><\/pre>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\">2. \u5e94\u7528\u5c42 YourProject.Application<\/h3>\n\n\n\n<h4 class=\"wp-block-heading\">\u9879\u76ee\u5f15\u7528<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\u9879\u76ee\u5f15\u7528\uff1a<code>YourProject.Domain<\/code><\/li>\n\n\n\n<li>NuGet\uff1aMediatR\u3001FluentValidation\u3001AutoMapper.Extensions.Microsoft.DependencyInjection<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">\u76ee\u5f55\u7ed3\u6784<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">plaintext<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code><code>Application\n\u251c\u2500 Dtos             # \u8f93\u5165\u8f93\u51faDTO\n\u251c\u2500 CQRS\n\u2502  \u251c\u2500 Commands      # \u4fee\u6539\u64cd\u4f5c\uff08Add\/Update\/Delete\uff09\n\u2502  \u2514\u2500 Queries       # \u67e5\u8be2\u64cd\u4f5c\n\u251c\u2500 Validators       # FluentValidation\u6821\u9a8c\u5668\n\u251c\u2500 Mappings         # AutoMapper\u6620\u5c04\u914d\u7f6e\n\u2514\u2500 DependencyInjection.cs  # \u5e94\u7528\u5c42DI\u6ce8\u518c\u6269\u5c55\n<\/code><\/code><\/pre>\n\n\n\n<h5 class=\"wp-block-heading\">2.1 DTO \u793a\u4f8b Dtos\/UserDto.cs<\/h5>\n\n\n\n<p class=\"wp-block-paragraph\">csharp<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\u8fd0\u884c<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code><code>namespace YourProject.Application.Dtos;\n\npublic class UserDto\n{\n    public long Id { get; set; }\n    public string UserName { get; set; } = string.Empty;\n    public string Phone { get; set; } = string.Empty;\n    public DateTime CreateTime { get; set; }\n}\n\n\/\/ \u521b\u5efa\u7528\u6237\u5165\u53c2\npublic class CreateUserInput\n{\n    public string UserName { get; set; } = string.Empty;\n    public string Password { get; set; } = string.Empty;\n    public string Phone { get; set; } = string.Empty;\n}\n<\/code><\/code><\/pre>\n\n\n\n<h5 class=\"wp-block-heading\">2.2 CQRS Command \u793a\u4f8b CQRS\/Commands\/CreateUserCommand.cs<\/h5>\n\n\n\n<p class=\"wp-block-paragraph\">csharp<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\u8fd0\u884c<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code><code>using MediatR;\nusing YourProject.Application.Dtos;\nusing YourProject.Domain.Entities;\nusing YourProject.Domain.Interfaces;\n\nnamespace YourProject.Application.CQRS.Commands;\n\npublic record CreateUserCommand(CreateUserInput Input) : IRequest&lt;UserDto>;\n\npublic class CreateUserCommandHandler : IRequestHandler&lt;CreateUserCommand, UserDto>\n{\n    private readonly IUserRepository _userRepo;\n    private readonly IMapper _mapper;\n\n    public CreateUserCommandHandler(IUserRepository userRepo, IMapper mapper)\n    {\n        _userRepo = userRepo;\n        _mapper = mapper;\n    }\n\n    public async Task&lt;UserDto> Handle(CreateUserCommand request, CancellationToken cancellationToken)\n    {\n        var exist = await _userRepo.GetByNameAsync(request.Input.UserName, cancellationToken);\n        if (exist != null)\n            throw new BusinessException(4001, \"\u7528\u6237\u540d\u5df2\u5b58\u5728\");\n\n        var user = new User\n        {\n            UserName = request.Input.UserName,\n            PasswordHash = request.Input.Password, \/\/ \u751f\u4ea7\u505a\u52a0\u5bc6\n            Phone = request.Input.Phone,\n            CreateTime = DateTime.Now\n        };\n\n        await _userRepo.AddAsync(user, cancellationToken);\n        return _mapper.Map&lt;UserDto>(user);\n    }\n}<\/code>\n<\/code><\/pre>\n\n\n\n<h5 class=\"wp-block-heading\">2.3 \u53c2\u6570\u6821\u9a8c Validators\/CreateUserInputValidator.cs<\/h5>\n\n\n\n<p class=\"wp-block-paragraph\">csharp<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\u8fd0\u884c<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code><code>using FluentValidation;\nusing YourProject.Application.Dtos;\n\nnamespace YourProject.Application.Validators;\n\npublic class CreateUserInputValidator : AbstractValidator&lt;CreateUserInput>\n{\n    public CreateUserInputValidator()\n    {\n        RuleFor(x => x.UserName)\n            .NotEmpty().WithMessage(\"\u7528\u6237\u540d\u4e0d\u80fd\u4e3a\u7a7a\")\n            .Length(2, 20).WithMessage(\"\u7528\u6237\u540d\u957f\u5ea62-20\u4f4d\");\n\n        RuleFor(x => x.Password)\n            .NotEmpty().WithMessage(\"\u5bc6\u7801\u4e0d\u80fd\u4e3a\u7a7a\")\n            .MinimumLength(6).WithMessage(\"\u5bc6\u7801\u81f3\u5c116\u4f4d\");\n    }\n}<\/code>\n<\/code><\/pre>\n\n\n\n<h5 class=\"wp-block-heading\">2.4 AutoMapper \u6620\u5c04 Mappings\/MapperProfile.cs<\/h5>\n\n\n\n<p class=\"wp-block-paragraph\">csharp<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\u8fd0\u884c<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code><code>using AutoMapper;\nusing YourProject.Application.Dtos;\nusing YourProject.Domain.Entities;\n\nnamespace YourProject.Application.Mappings;\n\npublic class MapperProfile : Profile\n{\n    public MapperProfile()\n    {\n        CreateMap&lt;User, UserDto>();\n    }\n}\n<\/code><\/code><\/pre>\n\n\n\n<h5 class=\"wp-block-heading\">2.5 \u5e94\u7528\u5c42 DI \u6ce8\u518c DependencyInjection.cs<\/h5>\n\n\n\n<p class=\"wp-block-paragraph\">csharp<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\u8fd0\u884c<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code><code>using AutoMapper;\nusing FluentValidation;\nusing MediatR;\nusing Microsoft.Extensions.DependencyInjection;\nusing YourProject.Application.Mappings;\n\nnamespace YourProject.Application;\n\npublic static class DependencyInjection\n{\n    public static IServiceCollection AddApplication(this IServiceCollection services)\n    {\n        \/\/ MediatR\n        services.AddMediatR(cfg => cfg.RegisterServicesFromAssembly(typeof(DependencyInjection).Assembly));\n        \/\/ FluentValidation \u81ea\u52a8\u626b\u63cf\u5168\u90e8\u6821\u9a8c\u5668\n        services.AddValidatorsFromAssembly(typeof(DependencyInjection).Assembly);\n        \/\/ AutoMapper\n        services.AddAutoMapper(typeof(MapperProfile));\n\n        return services;\n    }\n}\n<\/code><\/code><\/pre>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\">3. \u57fa\u7840\u8bbe\u65bd\u5c42 YourProject.Infrastructure<\/h3>\n\n\n\n<h4 class=\"wp-block-heading\">\u9879\u76ee\u5f15\u7528<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\u9879\u76ee\u5f15\u7528\uff1a<code>YourProject.Domain<\/code><\/li>\n\n\n\n<li>NuGet\uff1aMicrosoft.EntityFrameworkCore\u3001Npgsql\/Microsoft.Data.SqlClient\u3001StackExchange.Redis<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">\u76ee\u5f55\u7ed3\u6784<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">plaintext<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code><code>Infrastructure\n\u251c\u2500 Persistence          # EF Core\u6570\u636e\u5e93\u4e0a\u4e0b\u6587\u3001\u4ed3\u50a8\u5b9e\u73b0\n\u251c\u2500 Cache                # Redis\u7f13\u5b58\u5c01\u88c5\n\u251c\u2500 DependencyInjection.cs\n<\/code><\/code><\/pre>\n\n\n\n<h5 class=\"wp-block-heading\">3.1 EF \u4e0a\u4e0b\u6587 Persistence\/AppDbContext.cs<\/h5>\n\n\n\n<p class=\"wp-block-paragraph\">csharp<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\u8fd0\u884c<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code><code>using Microsoft.EntityFrameworkCore;\nusing YourProject.Domain.Entities;\n\nnamespace YourProject.Infrastructure.Persistence;\n\npublic class AppDbContext : DbContext\n{\n    public AppDbContext(DbContextOptions&lt;AppDbContext> options) : base(options) { }\n\n    public DbSet&lt;User> Users => Set&lt;User>();\n\n    protected override void OnModelCreating(ModelBuilder modelBuilder)\n    {\n        \/\/ \u6279\u91cf\u52a0\u8f7d\u5b9e\u4f53\u914d\u7f6e\n        modelBuilder.ApplyConfigurationsFromAssembly(typeof(AppDbContext).Assembly);\n    }\n}\n<\/code><\/code><\/pre>\n\n\n\n<h5 class=\"wp-block-heading\">3.2 \u4ed3\u50a8\u5b9e\u73b0 Persistence\/Repositories\/UserRepository.cs<\/h5>\n\n\n\n<p class=\"wp-block-paragraph\">csharp<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\u8fd0\u884c<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code><code>using Microsoft.EntityFrameworkCore;\nusing YourProject.Domain.Entities;\nusing YourProject.Domain.Interfaces;\n\nnamespace YourProject.Infrastructure.Persistence.Repositories;\n\npublic class UserRepository : IUserRepository\n{\n    private readonly AppDbContext _db;\n    public UserRepository(AppDbContext db) => _db = db;\n\n    public async Task&lt;User?> GetByIdAsync(long id, CancellationToken ct = default)\n    {\n        return await _db.Users.AsNoTracking().FirstOrDefaultAsync(x => x.Id == id &amp;&amp; !x.IsDeleted, ct);\n    }\n\n    public async Task AddAsync(User user, CancellationToken ct = default)\n    {\n        await _db.Users.AddAsync(user, ct);\n        await _db.SaveChangesAsync(ct);\n    }\n\n    public async Task UpdateAsync(User user, CancellationToken ct = default)\n    {\n        _db.Users.Update(user);\n        await _db.SaveChangesAsync(ct);\n    }\n\n    public async Task DeleteAsync(User user, CancellationToken ct = default)\n    {\n        user.IsDeleted = true;\n        await UpdateAsync(user, ct);\n    }\n\n    public async Task&lt;User?> GetByNameAsync(string userName, CancellationToken ct = default)\n    {\n        return await _db.Users.AsNoTracking().FirstOrDefaultAsync(x => x.UserName == userName &amp;&amp; !x.IsDeleted, ct);\n    }\n}\n<\/code><\/code><\/pre>\n\n\n\n<h5 class=\"wp-block-heading\">3.3 \u57fa\u7840\u8bbe\u65bd DI \u6ce8\u518c DependencyInjection.cs<\/h5>\n\n\n\n<p class=\"wp-block-paragraph\">csharp<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\u8fd0\u884c<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code><code>using Microsoft.EntityFrameworkCore;\nusing Microsoft.Extensions.Configuration;\nusing Microsoft.Extensions.DependencyInjection;\nusing YourProject.Domain.Interfaces;\nusing YourProject.Infrastructure.Persistence;\nusing YourProject.Infrastructure.Persistence.Repositories;\n\nnamespace YourProject.Infrastructure;\n\npublic static class DependencyInjection\n{\n    public static IServiceCollection AddInfrastructure(this IServiceCollection services, IConfiguration cfg)\n    {\n        \/\/ EF Core\n        services.AddDbContext&lt;AppDbContext>(opt =>\n            opt.UseNpgsql(cfg.GetConnectionString(\"DefaultConnection\")));\n\n        \/\/ \u4ed3\u50a8\u5b9e\u73b0\u6ce8\u5165\n        services.AddScoped&lt;IUserRepository, UserRepository>();\n\n        return services;\n    }\n}<\/code>\n<\/code><\/pre>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\">4. \u8868\u793a\u5c42 WebApi YourProject.Api\uff08\u542f\u52a8\u5165\u53e3\uff09<\/h3>\n\n\n\n<h4 class=\"wp-block-heading\">NuGet \u5305<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">Microsoft.AspNetCore.Mvc.NewtonsoftJson\u3001Swashbuckle.AspNetCore\u3001Serilog.AspNetCore\u3001Microsoft.AspNetCore.Authentication.JwtBearer<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">\u76ee\u5f55\u7ed3\u6784<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">plaintext<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code><code>Api\n\u251c\u2500 Controllers          # API\u63a7\u5236\u5668\n\u251c\u2500 Middlewares          # \u5168\u5c40\u5f02\u5e38\u3001\u8bf7\u6c42\u65e5\u5fd7\u4e2d\u95f4\u4ef6\n\u251c\u2500 Filters              # \u63a5\u53e3\u9274\u6743\u8fc7\u6ee4\u5668\n\u251c\u2500 Models               # \u7edf\u4e00\u8fd4\u56de\u6a21\u578b\n\u251c\u2500 Extensions           # Jwt\u3001Swagger\u3001\u8de8\u57df\u6269\u5c55\n\u251c\u2500 appsettings.json\n\u2514\u2500 Program.cs\n<\/code><\/code><\/pre>\n\n\n\n<h5 class=\"wp-block-heading\">4.1 \u7edf\u4e00\u8fd4\u56de\u6a21\u578b Models\/ApiResult.cs<\/h5>\n\n\n\n<p class=\"wp-block-paragraph\">csharp<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\u8fd0\u884c<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code><code>namespace YourProject.Api.Models;\n\npublic class ApiResult&lt;T>\n{\n    public int Code { get; set; }\n    public string Msg { get; set; } = string.Empty;\n    public T? Data { get; set; }\n\n    public static ApiResult&lt;T> Success(T? data, string msg = \"\u64cd\u4f5c\u6210\u529f\")\n    {\n        return new ApiResult&lt;T> { Code = 200, Msg = msg, Data = data };\n    }\n\n    public static ApiResult&lt;T> Fail(int code, string msg)\n    {\n        return new ApiResult&lt;T> { Code = code, Msg = msg };\n    }\n}<\/code>\n<\/code><\/pre>\n\n\n\n<h5 class=\"wp-block-heading\">4.2 \u5168\u5c40\u5f02\u5e38\u4e2d\u95f4\u4ef6 Middlewares\/GlobalExceptionMiddleware.cs<\/h5>\n\n\n\n<p class=\"wp-block-paragraph\">csharp<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\u8fd0\u884c<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code><code>using Microsoft.AspNetCore.Http;\nusing Microsoft.Extensions.Logging;\nusing System.Text.Json;\nusing YourProject.Api.Models;\nusing YourProject.Domain.Exceptions;\n\nnamespace YourProject.Api.Middlewares;\n\npublic class GlobalExceptionMiddleware\n{\n    private readonly RequestDelegate _next;\n    private readonly ILogger&lt;GlobalExceptionMiddleware> _logger;\n\n    public GlobalExceptionMiddleware(RequestDelegate next, ILogger&lt;GlobalExceptionMiddleware> logger)\n    {\n        _next = next;\n        _logger = logger;\n    }\n\n    public async Task InvokeAsync(HttpContext context)\n    {\n        try\n        {\n            await _next(context);\n        }\n        catch (Exception ex)\n        {\n            await HandleExceptionAsync(context, ex);\n        }\n    }\n\n    private async Task HandleExceptionAsync(HttpContext ctx, Exception ex)\n    {\n        ctx.Response.ContentType = \"application\/json\";\n        ApiResult&lt;object> res;\n\n        if (ex is BusinessException busEx)\n        {\n            res = ApiResult&lt;object>.Fail(busEx.Code, busEx.Message);\n            _logger.LogWarning(\"\u4e1a\u52a1\u5f02\u5e38\uff1a{Msg}\", busEx.Message);\n        }\n        else\n        {\n            res = ApiResult&lt;object>.Fail(500, \"\u670d\u52a1\u5668\u5185\u90e8\u9519\u8bef\");\n            \/\/ \u751f\u4ea7\u73af\u5883\u4e0d\u8fd4\u56de\u5806\u6808\u7ed9\u524d\u7aef\n            _logger.LogError(ex, \"\u7cfb\u7edf\u672a\u77e5\u5f02\u5e38\");\n        }\n\n        var json = JsonSerializer.Serialize(res);\n        await ctx.Response.WriteAsync(json);\n    }\n}<\/code>\n<\/code><\/pre>\n\n\n\n<h5 class=\"wp-block-heading\">4.3 \u7528\u6237\u63a7\u5236\u5668 Controllers\/UserController.cs<\/h5>\n\n\n\n<p class=\"wp-block-paragraph\">csharp<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\u8fd0\u884c<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code><code>using MediatR;\nusing Microsoft.AspNetCore.Mvc;\nusing YourProject.Api.Models;\nusing YourProject.Application.CQRS.Commands;\nusing YourProject.Application.Dtos;\n\nnamespace YourProject.Api.Controllers;\n\n&#91;ApiController]\n&#91;Route(\"api\/&#91;controller]\")]\npublic class UserController : ControllerBase\n{\n    private readonly IMediator _mediator;\n    public UserController(IMediator mediator) => _mediator = mediator;\n\n    &#91;HttpPost(\"create\")]\n    public async Task&lt;ActionResult&lt;ApiResult&lt;UserDto>>> Create(CreateUserInput input)\n    {\n        var cmd = new CreateUserCommand(input);\n        var data = await _mediator.Send(cmd);\n        return Ok(ApiResult&lt;UserDto>.Success(data));\n    }\n}<\/code>\n<\/code><\/pre>\n\n\n\n<h5 class=\"wp-block-heading\">4.4 \u6838\u5fc3 Program.cs\uff08\u5b8c\u6574\u542f\u52a8\u914d\u7f6e\uff0c\u4ea7\u54c1\u7ea7\uff09<\/h5>\n\n\n\n<p class=\"wp-block-paragraph\">csharp<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\u8fd0\u884c<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code><code>using Serilog;\nusing YourProject.Application;\nusing YourProject.Infrastructure;\nusing YourProject.Api.Middlewares;\n\nvar builder = WebApplication.CreateBuilder(args);\n\n\/\/ 1. Serilog\u65e5\u5fd7\nLog.Logger = new LoggerConfiguration()\n    .ReadFrom.Configuration(builder.Configuration)\n    .Enrich.FromLogContext()\n    .CreateLogger();\nbuilder.Host.UseSerilog();\n\n\/\/ 2. \u5206\u5c42DI\u6ce8\u5165\nbuilder.Services.AddControllers()\n    .AddNewtonsoftJson();\nbuilder.Services.AddEndpointsApiExplorer();\n\n\/\/ \u4e09\u5c42\u4f9d\u8d56\u6ce8\u5165\nbuilder.Services.AddApplication();\nbuilder.Services.AddInfrastructure(builder.Configuration);\n\n\/\/ 3. Swagger\u3001\u8de8\u57df\u3001Jwt\u7b49\u6269\u5c55\u53ef\u81ea\u884c\u5c01\u88c5\nbuilder.Services.AddCors(opt =>\n{\n    opt.AddPolicy(\"AllowAll\", p =>\n    {\n        p.AllowAnyOrigin()\n         .AllowAnyMethod()\n         .AllowAnyHeader();\n    });\n});\n\nvar app = builder.Build();\n\n\/\/ \u751f\u4ea7\/\u5f00\u53d1\u533a\u5206\u7ba1\u9053\nif (app.Environment.IsDevelopment())\n{\n    app.UseDeveloperExceptionPage();\n}\n\napp.UseHttpsRedirection();\napp.UseCors(\"AllowAll\");\napp.UseAuthentication();\napp.UseAuthorization();\n\n\/\/ \u5168\u5c40\u5f02\u5e38\u4e2d\u95f4\u4ef6\u653e\u6700\u524d\u9762\napp.UseMiddleware&lt;GlobalExceptionMiddleware>();\n\napp.MapControllers();\n\ntry\n{\n    Log.Information(\"API\u670d\u52a1\u542f\u52a8\");\n    app.Run();\n}\ncatch (Exception ex)\n{\n    Log.Fatal(ex, \"\u670d\u52a1\u542f\u52a8\u5931\u8d25\");\n}\nfinally\n{\n    Log.CloseAndFlush();\n}<\/code>\n<\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\">\u4e09\u3001\u914d\u5957 appsettings.json \u57fa\u7840\u914d\u7f6e<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">json<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code><code>{\n  \"Logging\": {\n    \"LogLevel\": {\n      \"Default\": \"Information\",\n      \"Microsoft.AspNetCore\": \"Warning\"\n    }\n  },\n  \"ConnectionStrings\": {\n    \"DefaultConnection\": \"Host=127.0.0.1;Database=YourDb;Username=postgres;Password=123456\"\n  },\n  \"Serilog\": {\n    \"WriteTo\": &#91;\n      { \"Name\": \"Console\" },\n      {\n        \"Name\": \"File\",\n        \"Args\": { \"path\": \"logs\/log-.txt\", \"rollingInterval\": \"Day\" }\n      }\n    ]\n  },\n  \"AllowedHosts\": \"*\"\n}\n<\/code><\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\">\u56db\u3001\u5927\u5382\u5f3a\u5236\u7f16\u7801\u4f7f\u7528\u89c4\u5219<\/h2>\n\n\n\n<ol class=\"wp-block-list\">\n<li>\u6240\u6709 IO \u64cd\u4f5c\u5168\u90e8 <code>async\/await<\/code>\uff0c\u7981\u6b62 <code>.Result<\/code> \/ <code>.Wait()<\/code><\/li>\n\n\n\n<li>Controller \u53ea\u63a5\u6536\u53c2\u6570 + \u8c03\u7528 MediatR\uff0c\u65e0\u4efb\u4f55\u4e1a\u52a1\u903b\u8f91<\/li>\n\n\n\n<li>\u6570\u636e\u5e93\u5b9e\u4f53\u4e0d\u80fd\u76f4\u63a5\u8fd4\u56de\u524d\u7aef\uff0c\u5fc5\u987b\u7ecf\u8fc7 DTO \u9694\u79bb\u8131\u654f<\/li>\n\n\n\n<li>\u6240\u6709\u5165\u53c2\u7edf\u4e00 FluentValidation \u6821\u9a8c\uff0c\u4e0d\u5199 if \u5224\u65ad\u6821\u9a8c<\/li>\n\n\n\n<li>\u4e1a\u52a1\u5f02\u5e38\u7edf\u4e00\u629b <code>BusinessException<\/code>\uff0c\u5168\u5c40\u4e2d\u95f4\u4ef6\u6355\u83b7\u683c\u5f0f\u5316\u8fd4\u56de<\/li>\n\n\n\n<li>\u9886\u57df\u5c42\u5b8c\u5168\u89e3\u8026\uff0c\u4e0d\u4f9d\u8d56 EF\u3001Redis\u3001API \u4efb\u4f55\u5916\u90e8\u7ec4\u4ef6<\/li>\n\n\n\n<li>\u4ed3\u50a8\u53ea\u505a\u6570\u636e\u5b58\u53d6\uff0c\u590d\u6742\u4e1a\u52a1\u903b\u8f91\u5168\u90e8\u653e\u5230 Application CQRS Handler<\/li>\n<\/ol>\n\n\n\n<h2 class=\"wp-block-heading\">\u4e94\u3001\u5feb\u901f\u65b0\u5efa\u9879\u76ee\u547d\u4ee4\uff08.NET CLI\uff09<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">bash<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\u8fd0\u884c<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code><code># \u521b\u5efa\u56db\u5c42\u7c7b\u5e93+API\ndotnet new classlib -n YourProject.Domain\ndotnet new classlib -n YourProject.Application\ndotnet new classlib -n YourProject.Infrastructure\ndotnet new webapi -n YourProject.Api\n\n# \u6dfb\u52a0\u9879\u76ee\u5f15\u7528\ndotnet add YourProject.Application reference YourProject.Domain\ndotnet add YourProject.Infrastructure reference YourProject.Domain\ndotnet add YourProject.Api reference YourProject.Application\ndotnet add YourProject.Api reference YourProject.Infrastructure<\/code><\/code><\/pre>\n","protected":false},"excerpt":{"rendered":"<p>\u4e00\u3001\u89e3\u51b3\u65b9\u6848\u5206\u5c42\u7ed3\u6784\uff08\u5927\u5382\u6807\u51c6 4 \u5c42\u6d0b\u8471\u67b6\u6784\uff09 plaintext \u4e8c\u3001\u6bcf\u5c42\u5b8c\u6574\u4ee3\u7801\u9aa8\u67b6\uff08\u53ef\u76f4\u63a5\u590d\u5236\u65b0\u5efa\u7c7b\u5e93 [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[13,25],"tags":[12,24],"class_list":["post-289","post","type-post","status-publish","format-standard","hentry","category-13","category-25","tag-12","tag-24"],"_links":{"self":[{"href":"https:\/\/www.erwa.cn\/index.php\/wp-json\/wp\/v2\/posts\/289","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.erwa.cn\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.erwa.cn\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.erwa.cn\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.erwa.cn\/index.php\/wp-json\/wp\/v2\/comments?post=289"}],"version-history":[{"count":1,"href":"https:\/\/www.erwa.cn\/index.php\/wp-json\/wp\/v2\/posts\/289\/revisions"}],"predecessor-version":[{"id":290,"href":"https:\/\/www.erwa.cn\/index.php\/wp-json\/wp\/v2\/posts\/289\/revisions\/290"}],"wp:attachment":[{"href":"https:\/\/www.erwa.cn\/index.php\/wp-json\/wp\/v2\/media?parent=289"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.erwa.cn\/index.php\/wp-json\/wp\/v2\/categories?post=289"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.erwa.cn\/index.php\/wp-json\/wp\/v2\/tags?post=289"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}