1. 项目背景与核心价值在传统企业信息系统升级过程中审批流集成往往是最难啃的骨头之一。我最近刚完成一个制造业ERP系统与飞书审批的深度集成项目这套方案让客户的老.NET系统重获新生。传统审批模块通常存在三个痛点一是移动端体验差二是多系统审批无法统一管理三是历史数据难以追溯。而飞书审批流恰好能完美解决这些问题。通过开放平台API我们可以将已有系统的业务数据与飞书审批引擎无缝衔接。这种混合架构既保留了传统系统的业务处理能力又获得了飞书在移动办公、消息推送、权限管理方面的原生优势。实测下来用户审批效率提升60%以上特别是需要现场拍照、GPS定位等移动特性的场景效果尤为显著。2. 技术架构设计要点2.1 混合架构设计核心采用事件驱动API网关模式[传统系统] → [消息队列] → [集成中间件] ↔ [飞书API] ↑ [审批结果回调]具体组件选型消息队列RabbitMQ兼容性好.NET生态支持完善集成中间件ASP.NET Core WebAPI推荐5.0版本数据库保留原系统SQL Server新增审批映射表2.2 飞书API关键端点必须掌握的三个核心接口审批实例创建/open-apis/approval/v4/instances审批详情查询/open-apis/approval/v4/instances/{instance_id}审批回调注册/open-apis/event/v1/outbound_ip特别注意飞书API的限流策略默认QPS5超过会返回429错误。我们在中间件层实现了令牌桶算法进行流量控制。3. 详细实现步骤3.1 环境准备飞书开发者账号申请# 需要准备的材料 - 企业营业执照 - 管理员身份证正反面 - 应用使用场景说明文档创建自建应用务必开启审批权限组所有权限记住App ID和App Secret后续获取access_token用.NET环境配置!-- 必备NuGet包 -- PackageReference IncludeMicrosoft.AspNetCore.Authentication.JwtBearer Version6.0.8 / PackageReference IncludeRabbitMQ.Client Version6.4.0 /3.2 审批模板配置在飞书后台创建审批模板时有几个关键字段需要特别注意字段类型映射规则示例值单行文本对应DB字段varchar{{form.leave_reason}}数字需显式类型转换(int){{form.days}}附件需先上传到飞书服务器file_token踩坑提醒飞书审批表单的字段ID是随机生成的UUID建议先在后台手动创建模板然后通过API获取字段映射关系。3.3 核心代码实现审批发起逻辑示例public async Taskstring CreateApprovalInstance(ApprovalRequest request) { var token await GetFeishuToken(); using var client new HttpClient(); var body new { approval_code 3C3D3F1A-1B1C-4D4E-9F9E-8D7C6B5A4A3B, user_id request.UserId, form JObject.Parse(request.FormJson) }; client.DefaultRequestHeaders.Authorization new AuthenticationHeaderValue(Bearer, token); var response await client.PostAsJsonAsync( https://open.feishu.cn/open-apis/approval/v4/instances, body); if(!response.IsSuccessStatusCode) { var error await response.Content.ReadAsStringAsync(); _logger.LogError($审批创建失败{error}); throw new ApiException(审批创建异常); } var result await response.Content.ReadFromJsonAsyncFeishuResponse(); return result.Data.InstanceId; }4. 实战避坑指南4.1 签名验证问题飞书回调使用RSA-SHA256签名但.NET默认的RSA实现与飞书标准有差异。建议使用以下验证方法bool VerifySignature(string timestamp, string nonce, string body, string signature) { var key Encoding.UTF8.GetBytes(your_encrypt_key); using var hmac new HMACSHA256(key); var data ${timestamp}\n{nonce}\n{body}; var computed hmac.ComputeHash(Encoding.UTF8.GetBytes(data)); return Convert.ToHexString(computed) signature; }4.2 数据一致性问题我们采用最终一致性方案本地事务先更新业务状态通过消息队列异步发起审批定时任务补偿异常实例关键补偿SQLSELECT a.* FROM Approvals a LEFT JOIN ApprovalInstances i ON a.InstanceId i.Id WHERE a.Status Processing AND i.UpdateTime DATEADD(HOUR, -2, GETDATE())4.3 移动端适配技巧飞书审批详情页支持自定义跳转链接我们可以深度集成H5页面// 在审批通过回调中注入跳转逻辑 window.feishu.bridge.invoke(biz.util.openLink, { url: /approval/detail?id${instanceId}, target: self });5. 性能优化实践5.1 批处理策略对于批量审批场景如财务报销我们实现了打包提交var batch new ListTask(); foreach(var item in requests) { batch.Add(CreateApprovalAsync(item)); } await Task.WhenAll(batch);配合Redis计数器控制并发量var count await _redis.IncrementAsync(approval_counter); if(count 50) { await Task.Delay(1000); }5.2 缓存设计采用三级缓存策略内存缓存Microsoft.Extensions.Caching.Memory短时效数据Redis缓存StackExchange.Redis用户权限等本地数据库SQL Server业务数据缓存更新策略graph LR A[审批创建] -- B[清除模板缓存] C[审批通过] -- D[更新业务缓存] E[审批拒绝] -- D6. 安全防护措施6.1 接口防护所有API接口必须实现JWT认证请求签名参数过滤示例过滤器public class FeishuSecurityFilter : IActionFilter { public void OnActionExecuting(ActionExecutingContext context) { var headers context.HttpContext.Request.Headers; if(!headers.ContainsKey(X-Request-Id) || !headers.ContainsKey(X-Timestamp)) { context.Result new UnauthorizedResult(); } var sign ComputeSignature(headers); if(sign ! headers[X-Signature]) { context.Result new ForbidResult(); } } }6.2 数据加密敏感字段采用AES-GCM加密public string Encrypt(string plainText) { using var aes new AesGcm(_key); var nonce new byte[12]; RandomNumberGenerator.Fill(nonce); var cipherText new byte[plainText.Length]; var tag new byte[16]; aes.Encrypt(nonce, Encoding.UTF8.GetBytes(plainText), cipherText, tag); return Convert.ToBase64String(nonce) : Convert.ToBase64String(cipherText) : Convert.ToBase64String(tag); }7. 监控与运维7.1 健康检查在Startup中配置services.AddHealthChecks() .AddRabbitMQ() .AddSqlServer(_config.GetConnectionString(Default)) .AddRedis(redis_connection);7.2 日志分析采用ELK方案日志格式规范{ timestamp: 2023-06-15T12:00:00Z, level: Error, message: 审批创建失败, instanceId: 123456, exception: ... }关键Kibana看板API响应时间分布审批状态统计异常类型排行8. 扩展场景实现8.1 会签场景处理对于需要多人审批的场景可以通过扩展字段实现form.Add(approvers, JArray.FromObject(new[]{ new { typeuser, idou_xxxx1 }, new { typedepartment, idod_xxxx } }));8.2 关联审批实现审批链的关键代码public async Task ChainApprove(string parentId) { var parent await GetApproval(parentId); if(parent.Status ! Approved) return; var child new ApprovalRequest { FormJson BuildChildForm(parent) }; await CreateApprovalInstance(child); }8.3 离线审批针对无网络环境实现本地缓存方案public void SaveOffline(ApprovalRequest request) { var file Path.Combine(OfflinePath, ${Guid.NewGuid()}.json); File.WriteAllText(file, JsonSerializer.Serialize(request)); if(Connectivity.NetworkAccess NetworkAccess.Internet) { _ ProcessOfflineFiles(); // 后台同步 } }这套方案已经在三个大型制造企业落地实施最复杂的场景实现了跨5个系统的审批流整合。核心在于理解飞书审批的开放能力边界合理设计补偿机制。建议初次实施时先从请假、报销等简单流程入手再逐步扩展到复杂业务流程。 企业ERP系统与飞书审批流集成实战
1. 项目背景与核心价值在传统企业信息系统升级过程中审批流集成往往是最难啃的骨头之一。我最近刚完成一个制造业ERP系统与飞书审批的深度集成项目这套方案让客户的老.NET系统重获新生。传统审批模块通常存在三个痛点一是移动端体验差二是多系统审批无法统一管理三是历史数据难以追溯。而飞书审批流恰好能完美解决这些问题。通过开放平台API我们可以将已有系统的业务数据与飞书审批引擎无缝衔接。这种混合架构既保留了传统系统的业务处理能力又获得了飞书在移动办公、消息推送、权限管理方面的原生优势。实测下来用户审批效率提升60%以上特别是需要现场拍照、GPS定位等移动特性的场景效果尤为显著。2. 技术架构设计要点2.1 混合架构设计核心采用事件驱动API网关模式[传统系统] → [消息队列] → [集成中间件] ↔ [飞书API] ↑ [审批结果回调]具体组件选型消息队列RabbitMQ兼容性好.NET生态支持完善集成中间件ASP.NET Core WebAPI推荐5.0版本数据库保留原系统SQL Server新增审批映射表2.2 飞书API关键端点必须掌握的三个核心接口审批实例创建/open-apis/approval/v4/instances审批详情查询/open-apis/approval/v4/instances/{instance_id}审批回调注册/open-apis/event/v1/outbound_ip特别注意飞书API的限流策略默认QPS5超过会返回429错误。我们在中间件层实现了令牌桶算法进行流量控制。3. 详细实现步骤3.1 环境准备飞书开发者账号申请# 需要准备的材料 - 企业营业执照 - 管理员身份证正反面 - 应用使用场景说明文档创建自建应用务必开启审批权限组所有权限记住App ID和App Secret后续获取access_token用.NET环境配置!-- 必备NuGet包 -- PackageReference IncludeMicrosoft.AspNetCore.Authentication.JwtBearer Version6.0.8 / PackageReference IncludeRabbitMQ.Client Version6.4.0 /3.2 审批模板配置在飞书后台创建审批模板时有几个关键字段需要特别注意字段类型映射规则示例值单行文本对应DB字段varchar{{form.leave_reason}}数字需显式类型转换(int){{form.days}}附件需先上传到飞书服务器file_token踩坑提醒飞书审批表单的字段ID是随机生成的UUID建议先在后台手动创建模板然后通过API获取字段映射关系。3.3 核心代码实现审批发起逻辑示例public async Taskstring CreateApprovalInstance(ApprovalRequest request) { var token await GetFeishuToken(); using var client new HttpClient(); var body new { approval_code 3C3D3F1A-1B1C-4D4E-9F9E-8D7C6B5A4A3B, user_id request.UserId, form JObject.Parse(request.FormJson) }; client.DefaultRequestHeaders.Authorization new AuthenticationHeaderValue(Bearer, token); var response await client.PostAsJsonAsync( https://open.feishu.cn/open-apis/approval/v4/instances, body); if(!response.IsSuccessStatusCode) { var error await response.Content.ReadAsStringAsync(); _logger.LogError($审批创建失败{error}); throw new ApiException(审批创建异常); } var result await response.Content.ReadFromJsonAsyncFeishuResponse(); return result.Data.InstanceId; }4. 实战避坑指南4.1 签名验证问题飞书回调使用RSA-SHA256签名但.NET默认的RSA实现与飞书标准有差异。建议使用以下验证方法bool VerifySignature(string timestamp, string nonce, string body, string signature) { var key Encoding.UTF8.GetBytes(your_encrypt_key); using var hmac new HMACSHA256(key); var data ${timestamp}\n{nonce}\n{body}; var computed hmac.ComputeHash(Encoding.UTF8.GetBytes(data)); return Convert.ToHexString(computed) signature; }4.2 数据一致性问题我们采用最终一致性方案本地事务先更新业务状态通过消息队列异步发起审批定时任务补偿异常实例关键补偿SQLSELECT a.* FROM Approvals a LEFT JOIN ApprovalInstances i ON a.InstanceId i.Id WHERE a.Status Processing AND i.UpdateTime DATEADD(HOUR, -2, GETDATE())4.3 移动端适配技巧飞书审批详情页支持自定义跳转链接我们可以深度集成H5页面// 在审批通过回调中注入跳转逻辑 window.feishu.bridge.invoke(biz.util.openLink, { url: /approval/detail?id${instanceId}, target: self });5. 性能优化实践5.1 批处理策略对于批量审批场景如财务报销我们实现了打包提交var batch new ListTask(); foreach(var item in requests) { batch.Add(CreateApprovalAsync(item)); } await Task.WhenAll(batch);配合Redis计数器控制并发量var count await _redis.IncrementAsync(approval_counter); if(count 50) { await Task.Delay(1000); }5.2 缓存设计采用三级缓存策略内存缓存Microsoft.Extensions.Caching.Memory短时效数据Redis缓存StackExchange.Redis用户权限等本地数据库SQL Server业务数据缓存更新策略graph LR A[审批创建] -- B[清除模板缓存] C[审批通过] -- D[更新业务缓存] E[审批拒绝] -- D6. 安全防护措施6.1 接口防护所有API接口必须实现JWT认证请求签名参数过滤示例过滤器public class FeishuSecurityFilter : IActionFilter { public void OnActionExecuting(ActionExecutingContext context) { var headers context.HttpContext.Request.Headers; if(!headers.ContainsKey(X-Request-Id) || !headers.ContainsKey(X-Timestamp)) { context.Result new UnauthorizedResult(); } var sign ComputeSignature(headers); if(sign ! headers[X-Signature]) { context.Result new ForbidResult(); } } }6.2 数据加密敏感字段采用AES-GCM加密public string Encrypt(string plainText) { using var aes new AesGcm(_key); var nonce new byte[12]; RandomNumberGenerator.Fill(nonce); var cipherText new byte[plainText.Length]; var tag new byte[16]; aes.Encrypt(nonce, Encoding.UTF8.GetBytes(plainText), cipherText, tag); return Convert.ToBase64String(nonce) : Convert.ToBase64String(cipherText) : Convert.ToBase64String(tag); }7. 监控与运维7.1 健康检查在Startup中配置services.AddHealthChecks() .AddRabbitMQ() .AddSqlServer(_config.GetConnectionString(Default)) .AddRedis(redis_connection);7.2 日志分析采用ELK方案日志格式规范{ timestamp: 2023-06-15T12:00:00Z, level: Error, message: 审批创建失败, instanceId: 123456, exception: ... }关键Kibana看板API响应时间分布审批状态统计异常类型排行8. 扩展场景实现8.1 会签场景处理对于需要多人审批的场景可以通过扩展字段实现form.Add(approvers, JArray.FromObject(new[]{ new { typeuser, idou_xxxx1 }, new { typedepartment, idod_xxxx } }));8.2 关联审批实现审批链的关键代码public async Task ChainApprove(string parentId) { var parent await GetApproval(parentId); if(parent.Status ! Approved) return; var child new ApprovalRequest { FormJson BuildChildForm(parent) }; await CreateApprovalInstance(child); }8.3 离线审批针对无网络环境实现本地缓存方案public void SaveOffline(ApprovalRequest request) { var file Path.Combine(OfflinePath, ${Guid.NewGuid()}.json); File.WriteAllText(file, JsonSerializer.Serialize(request)); if(Connectivity.NetworkAccess NetworkAccess.Internet) { _ ProcessOfflineFiles(); // 后台同步 } }这套方案已经在三个大型制造企业落地实施最复杂的场景实现了跨5个系统的审批流整合。核心在于理解飞书审批的开放能力边界合理设计补偿机制。建议初次实施时先从请假、报销等简单流程入手再逐步扩展到复杂业务流程。