微信公众号网页授权采用OAuth2.0授权码模式,用户点击授权后微信服务器会携带code和state参数重定向到开发者配置的回调地址。这个code在URL查询参数中传输,只要页面地址被记录、被转发或被统计脚本读取,就可能暴露。围绕暴露面、加密边界和可落地的防护实现,下面逐步拆解。

一、code在传输过程中会经过哪些暴露点
微信网页授权回调地址通常长这样:
https://ipipp.com/auth/callback?code=071abc...&state=xyz123
回调完成后,浏览器地址栏会完整显示这个URL。用户可能截图、收藏、通过聊天工具转发,甚至在浏览器历史记录中留下带code的地址。与此同时,如果网页内还有外链图片、统计脚本或跳转按钮,浏览器在跳转或加载资源时会带上Referer头,原URL中的查询参数也会被第三方服务器看到。即使页面本身没有外链,接入Nginx、Tomcat、K8s Ingress等网关时,默认访问日志通常记录整个请求URI,query中的code会直接落盘。
不少攻击方式并不需要正面突破HTTPS。攻击者可以通过社会工程学拿到用户分享的链接,或者从内部日志系统、监控平台、异常上报信息中检索到尚未过期的code。微信code的有效期只有五分钟,并且只能换取一次access_token,这确实是缓解措施,但不足以让团队忽视其暴露面。尤其是当secret管理不严格、前端配置或源码包泄露了appsecret时,一个日志中的code就可能被快速利用。
因此,风险不是单纯来自HTTP明文传输,而是来自code长期留在客户端、日志和跳转链路上。防护也要从这些环节同时下手。
二、code为什么不能自行加密,正确做法是什么
看到URL里的code,一种常见误判是对它做一层AES或RSA加密再传给后端,避免明文暴露。这个想法在实际微信授权流程中不可行。微信服务器回调时只会携带明文code,如果前端对code做对称加密,那么后端拿到的只是一段密文,调用微信接口换取access_token时必须传回明文code,否则微信会返回invalid code。也就是说,除非把加密后的code再还原成明文,否则授权链路直接中断。
更关键的是,即使前端把code加密成密文放在URL里,密文依然会出现在浏览器地址栏、日志和Referer中,真正的暴露面并没有减少。攻击者拿到密文后,如果前端密钥写在JS里,解密成本几乎为零。所以对code加密的正确理解不是应用层参数加密,而是把传输层收紧到HTTPS,并尽量让浏览器不直接持有code。
推荐的做法有三种:一是所有授权跳转和回调都强制走HTTPS,申请受信任的CA证书,redirect_uri只允许https协议;二是把微信授权发起和回调处理放到服务端,浏览器先访问自己的服务端接口,由服务端302到微信授权地址,回调时也由服务端接收code并立即换取token,处理后清空query再跳回业务页;三是在回调页面加入Referrer-Policy,避免外链和统计请求带走URL。通过服务端中转后,前端JavaScript完全不用感知code,即使页面被截图或分享,业务地址上也没有这个参数。
三、服务端换取access_token的安全实现
服务端处理微信网页授权一般包含两步:先拼装授权地址并让用户跳转,再处理回调并用code换取access_token。下面以PHP为例给出关键代码,重点是state参数的生成与校验、URL编码以及换取token后的跳转清理。
<?php
session_start();
$appid = 'wx1234567890';
$secret = '你的appsecret';
$redirect = 'https://ipipp.com/auth/callback';
// 生成随机state,并写入session用于回调校验
$state = bin2hex(random_bytes(16));
$_SESSION['oauth_state'] = $state;
$_SESSION['oauth_state_time'] = time();
$query = http_build_query([
'appid' => $appid,
'redirect_uri' => $redirect,
'response_type' => 'code',
'scope' => 'snsapi_userinfo',
'state' => $state,
]);
$authUrl = 'https://open.weixin.qq.com/connect/oauth2/authorize?' . $query . '#wechat_redirect';
header('Location: ' . $authUrl);
exit;
上面的http_build_query会自动对回调地址做URL编码,state用随机字节生成,并写入服务端会话。授权成功后,微信会回调到下面的处理逻辑:
<?php
session_start();
$code = $_GET['code'] ?? '';
$state = $_GET['state'] ?? '';
// 校验state,防CSRF和授权劫持
if (empty($code) || empty($state) || $state !== ($_SESSION['oauth_state'] ?? '')) {
exit('state校验失败');
}
// 防止state重复使用,校验后立即销毁
unset($_SESSION['oauth_state'], $_SESSION['oauth_state_time']);
$appid = 'wx1234567890';
$secret = '你的appsecret';
$tokenUrl = 'https://api.weixin.qq.com/sns/oauth2/access_token?'
. http_build_query([
'appid' => $appid,
'secret' => $secret,
'code' => $code,
'grant_type' => 'authorization_code',
]);
$ch = curl_init($tokenUrl);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
if (isset($data['errcode'])) {
exit('换取token失败:' . $data['errmsg']);
}
// $data里包含access_token、openid、refresh_token等,按业务保存
$_SESSION['openid'] = $data['openid'];
$_SESSION['access_token'] = $data['access_token'];
// 将页面URL中的code清除,避免刷新或外链泄露
header('Location: https://ipipp.com/auth/clean');
exit;
这段代码在处理token后不把code留在浏览器地址栏,而是重定向到一个不含code的业务页面。换取token的请求全部在服务端完成,curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true)显式开启HTTPS证书校验,可以防止中间人替换证书。需要提醒的是,appsecret只能保存在服务端,任何把它打包进前端资源、小程序包或配置文件并提交到代码仓库的做法,都会让code泄露的风险急剧上升。
四、日志脱敏与浏览器端清理的加固清单
即便服务端做了中转,入口网关仍可能记录原始回调URL。Nginx默认的访问日志会把$request或$request_uri整体输出,其中包含code参数。建议在日志格式中排除query部分,或对code参数做正则脱敏。下面是一个Nginx配置片段:
log_format safe '$remote_addr - $remote_user [$time_local] "$request_method $uri" '
'$status $body_bytes_sent "$http_referer" "$http_user_agent"';
access_log /var/log/nginx/wechat_access.log safe;
这里用$uri替代$request_uri,只记录路径而不记录查询参数,能直接从日志源头去掉code。如果业务确实需要保留query做排障,可以再配合map或日志清洗脚本,将code=后面的内容替换为code=[redacted],但不要使用完整的原始URL。
除了日志,回调页面还应设置以下响应头:
- Referrer-Policy:
no-referrer,防止外链资源或跳转目标拿到带code的Referer。 - Cache-Control:
no-store,避免浏览器把带code的响应页缓存下来。 - Content-Security-Policy: 限制页面可加载的脚本和图片来源,防止前端被注入恶意统计代码。
如果某些项目无法完全做到服务端中转,只能在浏览器端先拿到code再调后端接口,那么至少要在页面加载完成后通过history.replaceState把query清掉。示例:
if (window.location.search.indexOf('code') !== -1) {
var cleanUrl = window.location.pathname + window.location.hash;
window.history.replaceState(null, '', cleanUrl);
}
这段JS代码只负责清理浏览器地址栏,不参与code的传输和换取。真正的换取逻辑仍然必须放到服务端,前端不能直接携带code去访问微信的access_token接口,因为那会暴露secret。更稳妥的做法是前端把code发给自己的后端接口,由后端完成换取和存储,再返回登录态给前端。
五、从架构上减少code暴露的落地建议
对于用户量较大或安全要求较高的公众号应用,建议把授权流程拆成三个独立环节:前端业务页只发起登录请求,服务端接口负责生成微信授权地址并302跳转,回调服务负责接收code、校验state、换取token并建立会话。前端全程不接触code,也不需要在URL里传openid或token。业务页判断登录态失败后调用/auth/wechat/start,服务端完成授权后把登录态写入HttpOnly Cookie,再重定向回业务页面。
这样做有多个好处:一是code不会出现在前端可读的跳转链接中;二是appsecret始终只存在服务端;三是state可以在服务端用签名校验,攻击者很难伪造授权回调;四是日志清洗和HTTPS策略可以在服务端统一实施。缺点是增加了两次重定向和一次服务端会话维护,但相比泄露风险,这一点性能开销完全可以接受。
同时要注意公众号后台配置的网页授权域名必须是最终回调服务所在域名,且协议必须是HTTPS。不要在正式环境中使用IP地址、内网域名或临时测试域名作为回调地址,因为微信会校验域名匹配,而测试域名往往配置不规范,容易被误判为不安全。对于多环境部署,可以在公众号后台分别配置测试和生产域名,测试环境的授权域名也不应该被公网搜索引擎索引。