furion

项目地址： https://gitee.com/dotnetchina/Furion

GitHub 镜像： https://github.com/MonkSoul/Furion

官方文档： https://furion.net/

NuGet： Furion、Furion.Pure

许可证： MIT + Apache-2.0

概述

Furion 主要特性：

• 零配置启动：Inject() + AddInject() 自动激活
• 动态 API：实现 IDynamicApiController → 自动暴露 RESTful 接口
• 规范化结果：统一 RESTfulResult<T> 响应
• 依赖注入：ITransient/IScoped/ISingleton 标记接口自动注册
• 数据库：内置 SqlSugar 与 EF Core 双方案
• 鉴权：[Authorize] + JWT + 策略
• 远程请求：IHttpRemote + [HttpRequest] 配置式
• 定时任务：Furion.Schedule（基于 Quartz 类似的语法）
• 事件总线：本地 + RabbitMQ
• 配置：App.GetConfig、Config<TOptions>

Furion 适合 Admin.NET、企业内部系统、微服务后端。

安装

dotnet add package Furion
# 或基础版（不含全部子包）
dotnet add package Furion.Pure

启动配置

// Program.cs
var builder = WebApplication.CreateBuilder(args).Inject();   // 关键

builder.Services.AddControllers().AddInject();               // 关键

var app = builder.Build();
app.UseInject();                                             // 关键
app.MapControllers();
app.Run();

Inject() 会扫描程序集自动加载 Furion 的「应用启动模块」（AppStartup）。

动态 API

public class HelloService : IDynamicApiController
{
    public string Get() => "Hello Furion";
    public int Add(int a, int b) => a + b;
    public Task<List<User>> List() => /* ... */;
}

启动后自动暴露：

• GET /api/hello/get
• POST /api/hello/add
• GET /api/hello/list

可用 [ApiDescriptionSettings]、[HttpGet] 等控制路由。

规范化响应

默认所有接口返回：

{
  "statusCode": 200,
  "succeeded": true,
  "data": { ... },
  "errors": null,
  "extras": null,
  "timestamp": 1700000000
}

异常自动包装为：

{ "statusCode": 500, "succeeded": false, "errors": "ex.Message" }

可通过 App.Configuration["SpecificationDocumentSettings:..."] 关闭或自定义。

依赖注入

public interface IUserService { User GetById(int id); }

public class UserService : IUserService, ITransient
{
    public User GetById(int id) => /* ... */;
}

// 直接构造函数注入即可，无需 services.AddTransient<...>()
public class HelloService(IUserService userSvc) : IDynamicApiController { ... }