c#如何接入微信公众号_c#微信公众号最全用法总结

裘德小鎮的故事

裘德小鎮的故事

2026-04-23

201人浏览

原创

微信服务器get验证需原样返回echostr,且必须从request.querystring["echostr"]获取;checksignature需字典序排序三参数后拼接并sha1校验;post消息须用inputstream读取原始xml;access_token应使用concurrentdictionary缓存并防并发刷新。

c#如何接入微信公众号_c#微信公众号最全用法总结

微信服务器 GET 验证必须原样返回 echostr

接入失败最常见的原因是:收到微信 GET 请求后,没返回 echostr,或返回了带空格、换行、HTML 标签的字符串。微信只认纯文本且完全一致的 echostr 值。

关键点:

  • echostr 必须从 Request.QueryString["echoStr"] 取,注意大小写(是 echoStr,不是 echostrECHOSTR
  • 不能用 Response.Write("xxx") 后再执行其他逻辑——必须立刻终止响应,推荐用 Response.End()HttpContext.Current.Response.SuppressContent = true 防止后续输出污染
  • 不要设置 Content-Type,微信不校验,但设成 text/plain 最稳妥;设成 application/xmltext/html 会导致验证失败
  • 整个响应 body 必须只有 echostr 字符串,不能有 BOM、UTF-8 签名、前后空格

CheckSignature 的三个参数排序必须严格字典序

签名验证不是简单拼接 token + timestamp + nonce,而是先排序再拼。错误写法如 string.Concat(token, timestamp, nonce) 会始终失败。

正确做法:

  • tokentimestampnonce 放入字符串数组,调用 .OrderBy(x => x).ToArray()
  • string.Join("", sortedArray) 拼接,不是用 +string.Format
  • SHA1 计算前确保输入是 UTF-8 编码的 byte[],别用默认编码(尤其在中文 Windows 上)
  • 计算出的哈希值转小写十六进制字符串后,与微信传来的 signature(也是小写)逐字符比对

POST 消息体解析必须用原始 XML 流,不能依赖表单解码

微信发来的消息是标准 XML,Content-Type 为 text/xml,但 ASP.NET 默认会尝试按 application/x-www-form-urlencoded 解析请求体,导致 Request.Form 为空、Request.InputStream 被提前读取而变空。

微信公众平台开发入门教程 中文WORD版
微信公众平台开发入门教程 中文WORD版

由于微信的大热,为了更好的方便使用微信的用户查询一些信息,这篇文章是入门级的微信公众平台开发教程,需要的朋友可以参考下 这篇入门教程将引导你完成如下任务: 创建百度云平台应用启用微信公众平台开发模式获取订阅、文字、图片、语音、视频消息回复文本、图文及音乐消息程序开发

下载

安全读取方式:

  • HttpContext.Current.Request.InputStream,且必须在第一次访问前设置 Request.InputStream.Position = 0
  • 不要用 Request.BinaryReadRequest.GetBufferlessInputStream(.NET 4.5+ 中行为不稳定)
  • 推荐封装一个方法:new StreamReader(Request.InputStream, Encoding.UTF8).ReadToEnd(),并确保 Request.ContentLength > 0 才读
  • 如果用了 Web API 或 MVC,需禁用模型绑定对 XML 的自动处理,否则可能触发异常或截断数据

access_token 必须用 ConcurrentDictionary<string string></string> 缓存

微信接口要求每个 appid 共享同一个 access_token,且有效期 2 小时。多线程并发刷新时,若用普通 Dictionary + 手动锁,极易出现重复请求、token 覆盖、超限被封。

推荐方案:

  • 声明静态字段:private static readonly ConcurrentDictionary<string string> AccessTokenCache = new();</string>
  • AccessTokenCache.GetOrAdd(appid, key => FetchNewToken(key)) 获取,FetchNewToken 内部加分布式锁或使用内存栅栏保证单次刷新
  • 缓存值建议附带过期时间戳(如 (token, expiresAt) 元组),避免靠 DateTime.Now 判断时区/系统时间误差
  • 不要用 MemoryCache,它不保证强一致性,且在 IIS 应用池回收后丢失,无跨实例同步能力

真正容易被忽略的是:微信对同一 appidaccess_token 请求频率有限制,哪怕你缓存了,也要防止多个进程/实例同时发现过期、同时发起刷新请求——这正是 ConcurrentDictionaryGetOrAdd 能守住的关键防线。

相关文章

微信app下载
微信app下载

微信是一款手机通信软件,支持通过手机网络发送语音短信、视频、图片和文字。微信可以单聊及群聊,还能根据地理位置找到附近的人,带给大家全新的移动沟通体验,有需要的小伙伴快来保存下载体验吧!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
c#是什么意思
c#是什么意思

C#是一种通用的面向对象编程语言,它在.NET框架上运行,可用于开发各种类型的应用程序。本专题为大家提供c#相关的各种文章、以及下载和课程。

2023.08.08

528

5

什么是c#
什么是c#

C#(读作C Sharp)是一种现代的、通用的、面向对象的编程语言。它由微软公司开发,于2000年首次发布,主要用于开发Windows桌面应用程序、Web应用程序、移动应用程序以及游戏开发等领域。C#是一种类型安全和托管的编程语言,它结合了C++的强大性能和C语言的简单易学特点,并引入了许多新的特性和概念,如委托、属性、泛型和异步编程等,以提高开发效率和代码可维护性。

2023.08.31

1157

3

C#中base关键字的用法
C#中base关键字的用法

在C#中,base关键字用于访问当前类的基类成员,这包括基类的字段、属性、方法、构造函数、索引器以及事件。想了解更多C#的相关内容,可以阅读本专题下面的文章。

2024.03.13

556

8

C#Task用法
C#Task用法

Task在C#中是用于表示异步操作的对象,它位于System.Threading.Tasks命名空间中。想了解更多C#中各种用法的相关内容,可以阅读本专题下面的文章。

2024.03.14

1050

11

C# 并发与异步编程
C# 并发与异步编程

本专题系统讲解 C# 异步编程与并发控制,重点介绍 async 和 await 关键字、Task 类、线程池管理、并发数据结构、死锁与线程安全问题。通过多个实战项目,帮助学习者掌握 如何在 C# 中编写高效的异步代码,提升应用的并发性能与响应速度。

2026.02.03

148

18

C# 多线程与异步编程
C# 多线程与异步编程

本专题深入讲解 C# 中多线程与异步编程的核心概念与实战技巧,包括线程池管理、Task 类的使用、async/await 异步编程模式、并发控制与线程同步、死锁与竞态条件的解决方案。通过实际项目,帮助开发者掌握 如何在 C# 中构建高并发、低延迟的异步系统,提升应用性能和响应速度。

2026.02.06

202

20

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

2026.03.11

526

24

C# Unity游戏开发与ECS架构实践
C# Unity游戏开发与ECS架构实践

本专题聚焦 C# 在 Unity 游戏开发中的应用,系统讲解 ECS(Entity-Component-System)架构设计、游戏对象管理、性能优化与内存控制策略。通过实际游戏案例,帮助开发者构建高性能、结构清晰的游戏系统,提高游戏开发效率与运行性能。

2026.04.13

137

20

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP开发微信公众号平台从简到精
PHP开发微信公众号平台从简到精

共25课时 | 6.5万人学习

PHP开发微信公众号视频教程
PHP开发微信公众号视频教程

共5课时 | 1.7万人学习

PHP开发微信公众号视频教程
PHP开发微信公众号视频教程

共13课时 | 5.7万人学习