后端即时通讯金融科技【免费下载链接】WeiXinMPSDK微信全平台 .NET SDK Senparc.Weixin for C#支持 .NET Framework 及 .NET Core、.NET 10.0。已支持微信公众号、小程序、小游戏、微信支付、企业微信/企业号、开放平台、JSSDK、微信周边等全平台。 WeChat SDK for C#.项目地址https://gitcode.com/gh_mirrors/we/WeiXinMPSDK点击查看免费下载本文基于仓库根目录的 readme.en.md英文版项目说明展开覆盖 Senparc.Weixin 的平台能力版图、NuGet 模块体系、三行代码启动流程、AccessToken 全生命周期托管机制与 MessageHandler 消息处理中间件的完整用法。读完本文你将掌握在 .NET 6/8/10 环境下从零搭建一个微信公众号应用、调用高级接口并接收用户消息的完整路径且每一步都能在仓库源码中找到对应实现。项目定位与平台能力版图Senparc.Weixin 是一个覆盖微信全生态的 .NET SDK。根据其英文版说明文档它可以支撑以下平台的开发微信公众号Official Account / MP小程序与小游戏Mini Program / Mini Game / WxOpen企业微信Enterprise WeChat / Work微信开放平台Open Platform微信支付 V2 与 V3TenPay / TenPayV3JS-SDK、微信硬件/蓝牙等周边能力框架层面当前仓库同时提供面向.NET Framework 4.6.2对应 .NET Standard 2.x与 .NET 10.0向下兼容 .NET 5.0–9.0的多目标工程历史上还支持 .NET 3.5 / 4.0 / 4.5、.NET Core 2.x / 3.x。文档明确说明 SDK 与外部框架完全解耦可运行在 MVC、Razor、WebApi、Console 命令行、桌面应用.exe、Blazor、MAUI、后台服务等多种宿主环境——这正是其各核心库仅依赖 .NET Standard 2.0 的设计目标。功能支持清单Feature Supportreadme.en.md 中的 Feature Support 章节列出了 SDK 的核心能力完整继承如下支持大部分微信 8.x 接口包括微信支付、自定义菜单/个性化菜单、模板消息接口、素材上传接口、群发消息接口、客服接口、支付接口、微信卡券接口、发票接口等支持公众号、小程序、企业号、开放平台、微信支付等模块化拆分支持用户会话上下文MessageContext解决服务端无法使用 Session 管理用户信息的经典问题支持分布式缓存与缓存策略扩展默认内置本地缓存、Redis、Memcached并可自由扩展开发时无需关心具体缓存实现可在配置文件或运行时切换。文档还给出两条工程化承诺官方接口完全融合且升级尽量保证向后兼容开发者可放心通过 NuGet 直接升级 DLL也可以自行修改源码后编译——在Release模式下构建 Samples/All/net8-mvc 或 Samples/All/net10-mvc 解决方案可自动在/src/BuildOutPut/生成多版本 NuGet 包。模块库与 NuGet 包体系各微信模块被解耦为独立 DLL 与独立 NuGet 包可按需引用。readme.en.md 的 Libraries by Module 表格完整列出下表已去除外部徽章链接改为仓库内对应源码路径#模块DLL源码位置1核心库Senparc.Weixin.dllsrc/Senparc.Weixin2公众号 / JSSDK / 摇一摇等Senparc.Weixin.MP.dllsrc/Senparc.Weixin.MP3小程序含小游戏Senparc.Weixin.WxOpen.dllsrc/Senparc.Weixin.WxOpen4微信支付 V2Senparc.Weixin.TenPay.dllsrc/Senparc.Weixin.TenPay5微信支付 V3Senparc.Weixin.TenPayV3.dllsrc/Senparc.Weixin.TenPay/Senparc.Weixin.TenPayV36ASP.NET MVC 扩展Senparc.Weixin.MP.MvcExtension.dllsrc/Senparc.Weixin.MP.MvcExtension7企业号已停止运营Senparc.Weixin.QY.dll历史模块NuGet 仍可引用9企业微信Senparc.Weixin.Work.dllsrc/Senparc.Weixin.Work9微信开放平台Senparc.Weixin.Open.dllsrc/Senparc.Weixin.Open10Redis 分布式缓存Senparc.Weixin.Cache.Redis.dllsrc/Senparc.Weixin.Cache11Memcached 分布式缓存Senparc.Weixin.Cache.Memcached.dllsrc/Senparc.Weixin.Cache12WebSocket独立项目Senparc.WebSocket.dllsrc/Senparc.WebSocket13全家桶Senparc.Weixin.All.dllsrc/Senparc.Weixin.All此外还有三个 Web 宿主配套包Senparc.Weixin.MP.Middleware/Senparc.Weixin.Work.Middleware/Senparc.Weixin.WxOpen.Middleware消息处理中间件源码分别在 src/Senparc.Weixin.MP.Middleware 等目录以及Senparc.Weixin.AspNetWeb 支持类库src/Senparc.Weixin.AspNet。兼容性与版本约束来自原文档的 WARNING 提示.NET Framework 3.5 / 4.0 自 2019 年 5 月 1 日起不再更新.NET Framework 4.5 自 2022 年 4 月起被 4.6.2 取代若继续使用 .NET Framework文档建议按微软生命周期计划在支持结束前升级至 4.8。需要一次性引用所有模块时直接引用Senparc.Weixin.All即可。Hello World三行代码启动微信开发readme.en.md 的核心卖点是一套极简启动流程用 3 句代码开启微信开发之旅。以下以 Samples/MP/Senparc.Weixin.Sample.MP 为蓝本原文档同样以此示例目录为准逐步拆解并对照源码。第一步DI 容器注册一行代码在Program.cs的builder.Build()之前添加builder.Services.AddSenparcWeixinServices(builder.Configuration);若使用旧格式Startup.cs该行放入ConfigureServices()。该扩展方法定义在 src/Senparc.Weixin/Senparc.Weixin/RegisterServices/SenparcWeixinRegisterServiceExtension.csAddSenparcWeixinServices实际是AddSenparcWeixin的别名二者都会从IConfiguration中读取SenparcSetting与SenparcWeixinSetting两个配置节并注入 Options同时自动包含 CO2NET 全局服务注册AddSenparcGlobalServices。对照真实示例 Samples/MP/Senparc.Weixin.Sample.MP/Program.cs实际写法为builder.Services.AddSenparcWeixin(builder.Configuration);并且在使用内存缓存时还需要builder.Services.AddMemoryCache();。第二步启用微信配置并注册账号一行代码在builder.Build()之后调用var registerService app.UseSenparcWeixin(app.Environment, null, null, register { }, (register, weixinSetting) { // 注册公众号信息可以执行多次注册多个公众号 register.RegisterMpAccount(weixinSetting, 【盛派网络小助手】公众号); });使用旧格式Startup.cs时放入Configure()。各参数含义可从 src/Senparc.Weixin/Senparc.Weixin/WeixinRegister.cs 的源码注释中确认前两个null分别表示覆盖 appsettings 中已读取的 SenparcSetting / SenparcWeixinSetting 配置传null即沿用配置文件值第三个register { }是 CO2NET 全局配置委托第四个委托执行各平台账号的实际注册。RegisterMpAccount的实现在 src/Senparc.Weixin.MP/Senparc.Weixin.MP/Register.cs带ISenparcWeixinSettingForMP参数的重载会从SenparcWeixinSetting中提取 AppId/AppSecret写入全局配置字典键为自定义name便于管理员识别多个公众号最终调用AccessTokenContainer.Register(appId, appSecret, name)完成 AccessToken 容器的注册。自动注册模式如果引用了Senparc.Weixin.All可以追加autoRegisterAllPlatforms: true让 SDK 自动注册所有已配置平台的账号注册委托留空即可var registerService app.UseSenparcWeixin(app.Environment, null, null, register { }, (register, weixinSetting) { /* 无需手动注册 */ }, autoRegisterAllPlatforms: true /* 自动注册所有平台 */);配置项appsettings.json 中的两个配置节注册信息来自 Samples/MP/Senparc.Weixin.Sample.MP/appsettings.json包含两个关键节key 不可修改改了会被视为无法自动识别不用的参数可整条删除但字符串值不允许留空串{ SenparcSetting: { IsDebug: true, DefaultCacheNamespace: DefaultCache, Cache_Redis_Configuration: #{Cache_Redis_Configuration}#, Cache_Memcached_Configuration: #{Cache_Memcached_Configuration}#, SenparcUnionAgentKey: #{SenparcUnionAgentKey}# }, SenparcWeixinSetting: { IsDebug: true, Token: #{Token}#, EncodingAESKey: #{EncodingAESKey}#, WeixinAppId: #{WeixinAppId}#, WeixinAppSecret: #{WeixinAppSecret}# } }SenparcSettingCO2NET 全局配置含分布式缓存连接串Redis/Memcached不用可删除SenparcWeixinSetting微信全局配置。Token必须与微信公众平台后台【设置与开发】【基本配置】中设置的 Token 一致EncodingAESKey为消息加解密密钥WeixinAppId/WeixinAppSecret为公众号应用凭据。示例中的#{...}#是 CI 占位符实际使用时替换为明文即可。第三步调用高级接口一行代码在程序任意位置直接调用微信接口以客服消息为例await CustomApi.SendTextAsync(AppId, OpenId, Hello World!);原文档给出四条重要提示均有源码依据AccessToken 全生命周期自动托管——开发时只需提供 AppId无需处理 token 过期。这一点可从 src/Senparc.Weixin.MP/Senparc.Weixin.MP/Containers/AccessTokenContainer.cs 的文件头注释确认通用接口AccessToken容器用于自动管理AccessToken如果过期会重新获取注册信息自动注入AppId 等注册信息从全局的Senparc.Weixin.Config.SenparcWeixinSetting获取其值在UseSenparcWeixin初始化流程中写入见 WeixinRegister.cs同步版本同样可用Senparc.Weixin.MP.AdvancedAPIs.CustomApi.SendText()命名贴合官方文档所有接口的命名空间参照微信官方 API 路径规则定义参数命名尽量与官方文档一致尤其是返回字段便于在源码中快速定位、降低对接出错概率。原文档特别强调以上两行启动 一行调用的模式对所有微信模块通用学会公众号即可举一反三到小程序、企业微信、微信支付。公众号消息对话MessageHandler 两步接入公众号自带聊天窗口可收发文字、图片、语音等消息。SDK 提供MessageHandler抽象机制将消息分发封装为重写对应请求处理方法的模式同样适用于企业微信和小程序客服消息。接入只需两步。第一步创建自定义 MessageHandler继承MessageHandlerTMC示例使用默认消息上下文DefaultMpMessageContext重写需要处理的OnXXRequestAsync方法与兜底的DefaultResponseMessageusing Senparc.NeuChar.Entities; using Senparc.Weixin.MP.Entities; using Senparc.Weixin.MP.Entities.Request; using Senparc.Weixin.MP.MessageContexts; using Senparc.Weixin.MP.MessageHandlers; namespace Senparc.Weixin.Sample.MP { /// summary /// 自定义 MessageHandler /// 把 MessageHandler 作为基类重写对应请求的处理方法 /// /summary public partial class CustomMessageHandler : MessageHandlerDefaultMpMessageContext { public CustomMessageHandler(Stream inputStream, PostModel postModel, int maxRecordCount 0, bool onlyAllowEncryptMessage false, IServiceProvider serviceProvider null) : base(inputStream, postModel, maxRecordCount, onlyAllowEncryptMessage, null, serviceProvider) { } /// summary /// 所有未处理类型的默认消息 /// /summary public override IResponseMessageBase DefaultResponseMessage(IRequestMessageBase requestMessage) { // ResponseMessageText 也可以是 News 等其他类型 var responseMessage this.CreateResponseMessageResponseMessageText(); responseMessage.Content 你发送了一条消息但程序没有指定处理过程; return responseMessage; } public override TaskIResponseMessageBase OnImageRequestAsync(RequestMessageImage requestMessage) { // 处理图片请求... } public override TaskIResponseMessageBase OnLocationRequestAsync(RequestMessageLocation requestMessage) { // 处理地理位置请求... } } }对照完整示例 Samples/MP/Senparc.Weixin.Sample.MP/MessageHandlers/CustomMessageHandler.cs可以补充理解几个生产细节OnTextRequestAsync中演示了requestMessage.StartHandler()的关键字路由链支持精确关键字不区分大小写、按序匹配、Keywords批量匹配、Regex正则匹配、Default兜底比 if-else 判断Content更清晰构造函数中OnlyAllowEncryptMessage true可强制只接收加密消息以提升安全性GlobalMessageContext.ExpireMinutes控制消息上下文会话的缓存过期时间OnUnknownTypeRequestAsync用于兜底 SDK 尚未提供的未知消息类型可从requestMessage.RequestDocument拿到原始 XML通过重写OnExecutingAsync/OnExecutedAsync可以在每次消息执行前后读写MessageContext.StorageData实现跨请求的用户状态存储。第二步注册消息入口SDK 提供Middleware推荐与Controller或 WebApi两种接入方式任选其一。以中间件为例在Program.cs中启用配置后追加app.UseMessageHandlerForMp(/WeixinAsync, (stream, postModel, maxRecordCount, serviceProvider) new CustomMessageHandler(stream, postModel, maxRecordCount, false, serviceProvider), options { options.AccountSettingFunc context Senparc.Weixin.Config.SenparcWeixinSetting; });该扩展方法定义于 src/Senparc.Weixin.MP.Middleware/MessageHandlers/Middleware/MpMessageHandlerMiddleware.cs。从源码结构看中间件会完成全部脏活MpMessageHandlerMiddleware.GetPostModel同文件 L126-L141自动从请求 Query 中读取signature、timestamp、nonce、msg_signature并从AccountSettingFunc提供的配置中填充Token、AppId、EncodingAESKey随后默认调用messageHandler.ExecuteAsync()执行消息处理并回写 XML 响应——因此不需要编写任何 ControllerGET 请求的 URL 校验GetEchostr直接回显echostr也由中间件一并处理。options中的TextResponseLimitOptions用于设置文本回复长度上限配合 SDK 的长文本自动分片能力原文档公告中的 automatic long-text chunking and sending超限部分可自动通过客服接口分段发送。示例 Program.cs 中即配置了new TextResponseLimitOptions(2048, weixinSetting.WeixinAppId)。配置完成后将https://你的域名/WeixinAsync填入微信公众平台后台【设置与开发】【基本配置】 服务器地址URLToken 与 appsettings.json 保持一致即可开始收发消息。若需要对整个消息处理过程做更细粒度的控制或在 .NET Framework 中可选用Controller或 WebApi方式Controller 中依次完成接收消息流 →new CustomMessageHandler(Request.InputStream, postModel)→messageHandler.Execute()→return new FixWeixinBugWeixinResult(messageHandler)三步每一步各一行代码且必须对每次 POST 重新做CheckSignature.Check验签防止请求伪造。仓库结构源码与示例目录导读readme.en.md 的 Source Code Project Folders 与 Samples Folder 两节给出了官方目录地图结合仓库实际结构整理如下。src/ 源码目录目录说明src/Senparc.Weixin所有Senparc.Weixin.[x].dll基础库源码核心库src/Senparc.Weixin.MP公众号 SDK 源码AdvancedAPIs下含 250 接口文件src/Senparc.Weixin.MP.Middleware公众号消息中间件源码src/Senparc.Weixin.MP.MvcExtensionMVC 项目扩展包源码src/Senparc.Weixin.WxOpen小程序 SDK 源码含小游戏src/Senparc.Weixin.WxOpen.Middleware小程序消息中间件源码src/Senparc.Weixin.Work企业微信 SDK 源码src/Senparc.Weixin.Work.Middleware企业微信消息中间件源码src/Senparc.Weixin.Open第三方开放平台 SDK 源码src/Senparc.Weixin.TenPay微信支付 V2 与 V3 源码src/Senparc.Weixin.CacheRedis、CsRedis、Memcached、Dapr 等分布式缓存扩展src/Senparc.Weixin.AspNetWeb 支持类库src/Senparc.WebSocketWebSocket 模块src/Senparc.Weixin.All全家桶聚合工程多目标构建的公共属性集中在 src/Directory.Build.props各工程如 src/Senparc.Weixin.MP/Senparc.Weixin.MP/Senparc.Weixin.MP.net8.csproj 与.net10.csproj分别面向 .NET 8 与 .NET 10 编译同一份源码。Samples/ 示例目录目录说明Samples/MP公众号独立示例含 Simple 精简版NuGet 引用Samples/WxOpen小程序示例含小程序前端代码NuGet 引用Samples/Work企业微信示例NuGet 引用Samples/TenPayV2 / Samples/TenPayV3微信支付 V2 / V3 示例NuGet 引用Samples/All集成所有平台的综合示例进阶Samples/All/net10-mvc.NET 10.0 生产就绪示例源码引用推荐Samples/All/net8-mvc.NET 8.0 生产就绪示例源码引用Samples/All/net45-mvc.NET Framework 4.5 ASP.NET MVC 示例NuGet 引用Samples/All/console命令行 Console 示例.NET Core 风格Samples/Shared所有示例共用的静态资源Samples with AIAI 聊天机器人微信集成示例从源码结构看All目录下的示例工程如 Samples/All/net10-mvc/Senparc.Weixin.Sample.Net10包含 31 个 Controller覆盖菜单、JSSDK、OAuth2、模板消息、素材、客服等几乎全部场景且各示例只需配置微信参数、无需修改任何代码即可运行——这也是原文档强调学会一个模块即可举一反三的原因各模块的配置、注册、AccessToken 管理、消息处理、接口调用模式完全一致。更完整的进阶开发文档位于仓库的 docs 目录其中 docs/zh/guide 按模块组织公众号mp、小程序wxopen、企业微信work、微信支付 V2tenpayv2与 V3tenpayv3各有独立的安装、登录、JSSDK、OAuth 2.0、支付回调、退款等章节docs/README.md 还说明了如何基于 VitePress 在本地构建这些文档站点。部署与 .NET 开发路径原文档 Deployment guide 与 How to develop with .NET Core 两节给出两条部署路径Azure App ServiceAzure 对 .NET 支持良好SDK 的示例应用可直接发布为 Web App任意服务器 FTP安装 FTP 服务原文档推荐 FileZilla Server后上传编译产物即可。对应的可直接编译发布的示例是 Samples/All/net10-mvc 下的Senparc.Weixin.Sample.Net10工程无需修改代码使用云托管时 FTP 通常同样可用。关于开发版本的选择原文档说明当前分支包含 .NET Framework 4.6.2 与 .NET 6.0/7.0/8.0/10.0 的完整代码更早版本对应 releases 快照.NET 10.0 示例向下兼容 .NET 5.0–8.0 与 .NET Core 3.1位于Samples/All/net10-mvc.NET Framework 示例位于Samples/All/net45-mvc。需要注意net10-mvc示例直接引用各模块源码以Release模式构建时可产出多版本兼容的 NuGet 包若只是学习或生产部署建议使用 NuGet 包引用的Samples/MP、Samples/All/net8-mvc等工程。分支策略、贡献与许可分支原文档 Important Branches 表master为正式发布主分支稳定、可用于生产Developer为开发分支Beta新功能在此分支开发后再合并至 master建议向Developer而非master提交 Pull RequestBookVersion1为配套书籍出版时的代码快照NET4.02017 年停更与NET3.52015 年停更为历史兼容分支。贡献流程Fork → 创建特性分支 → Commit → Push → 向Developer分支发起 Pull Request。贡献者名单记录于 Contributors.md。许可项目采用Apache License 2.0见 license.md100% 开源、支持商业使用。小结readme.en.md 描述的 Senparc.Weixin 体系可以浓缩为三层能力配置层SenparcSetting/SenparcWeixinSetting双配置节 UseSenparcWeixin统一初始化、接口层AccessTokenContainer自动托管凭据各平台AdvancedAPIs按官方 API 命名的一行式调用、消息层MessageHandler 中间件的声明式消息处理。配合 Samples/MP 的完整可运行示例与 src 下各模块源码开发者可以用极少样板代码搭建出覆盖公众号、小程序、企业微信、支付与开放平台的生产级微信应用。赞分享后端即时通讯金融科技【免费下载链接】WeiXinMPSDK微信全平台 .NET SDK Senparc.Weixin for C#支持 .NET Framework 及 .NET Core、.NET 10.0。已支持微信公众号、小程序、小游戏、微信支付、企业微信/企业号、开放平台、JSSDK、微信周边等全平台。 WeChat SDK for C#.项目地址https://gitcode.com/gh_mirrors/we/WeiXinMPSDK点击查看免费下载相关推荐10个实战技巧使用llama-nemotron-embed-vl-1b-v2-fp8构建高效视觉文档检索系统10个实战技巧使用llama nemotron embed vl 1b v2 fp8构建高效视觉文档检索系统 llama nemotron embed vl后端即时通讯金融科技pytransform3d API完全参考从基础函数到高级变换操作pytransform3d API完全参考从基础函数到高级变换操作 pytransform3d是一个强大的Python库专注于3D变换操作提供了从基础旋转后端即时通讯金融科技Pig微服务平台实战指南从架构设计到生产部署全流程解析Pig微服务平台实战指南从架构设计到生产部署全流程解析 在现代企业级应用开发中微服务架构已经成为构建高可用、可扩展系统的首选方案。Pig项目作为一个基于Sp后端微服务认证鉴权API网关代码生成任务调度上一篇Conductor 项目状态监视实战用 /conductor:status 透视 Context-Driven Development 的 Track 进度、阻塞与下一步行动下一篇Tilt API完全指南程序化控制Kubernetes开发环境的终极教程创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考