微信网页授权域名限制解决方案：统一/代理授权入口设计

最新推荐文章于 2025-05-14 08:32:17 发布

热河暖男

最新推荐文章于 2025-05-14 08:32:17 发布

阅读量1.1k

点赞数 15

CC 4.0 BY-SA版权

文章标签：微信开放平台微信公众平台微信

本文链接：https://blog.youkuaiyun.com/wangchl0932/article/details/146158678

微信网页授权域名限制解决方案：统一/代理授权服务入口设计

背景问题

微信公众平台的网页授权功能要求开发者最多只能配置 两个授权回调域名，但在实际开发中，我们可能面临：

多业务系统：多个业务系统（如商城、活动页、客服系统）需要独立的域名。
多环境需求：测试环境、预发布环境、生产环境需要不同的域名。
上线限制：频繁修改授权域名会影响线上业务稳定性。

如何用一个域名支持多业务系统和多环境？本文将介绍 统一授权入口 的设计方案，并给出完整实现流程和代码示例。

解决方案：统一授权入口

通过一个 中间授权服务 统一处理所有微信授权请求，再将用户重定向到实际业务系统。
在这里插入图片描述

流程图说明

用户访问业务系统：业务系统生成授权链接，跳转到统一授权入口。
统一授权服务请求微信授权：携带业务系统的回调地址。
微信返回授权Code：用户授权后，微信将Code回调到统一授权服务。
统一服务换取用户信息：使用Code获取OpenID和用户信息。
重定向到业务系统：携带用户信息跳转回业务系统的实际页面。

实现步骤

1. 配置统一授权域名

在微信公众平台后台配置 一个统一的授权域名，例如：

https://auth.yourcompany.com

2. 开发统一授权服务（后端）

核心逻辑：接收微信回调的 code，换取用户信息，并重定向到业务系统。
使用 Spring Boot + WxJava 实现：

代码示例

@RestController
public class AuthController {

    @Autowired
    private WxMpService wxMpService;

    // 生成授权链接（供业务系统调用）
    @GetMapping("/generate-auth-url")
    public String generateAuthUrl(@RequestParam String targetUrl) {
        String redirectUri = "https://auth.yourcompany.com/auth/callback";
        String state = UUID.randomUUID().toString() + "|" + targetUrl; // 将业务回调地址嵌入state
        String authUrl = wxMpService.getOAuth2Service().buildAuthorizationUrl(
                redirectUri, 
                "snsapi_userinfo", 
                state
        );
        return authUrl;
    }

    // 处理微信回调
    @GetMapping("/auth/callback")
    public void authCallback(
            @RequestParam("code") String code,
            @RequestParam("state") String state,
            HttpServletResponse response) throws IOException {
        
        // 解析state中的业务回调地址
        String[] stateParts = state.split("\\|");
        String targetUrl = stateParts[1];

        try {
            // 换取用户信息
            WxMpOAuth2AccessToken accessToken = wxMpService.getOAuth2Service().getAccessToken(code);
            WxMpUser user = wxMpService.getOAuth2Service().getUserInfo(accessToken, null);
            
            // 构造重定向URL，携带用户信息
            String redirectUrl = targetUrl + 
                    "?openid=" + user.getOpenId() + 
                    "&nickname=" + URLEncoder.encode(user.getNickname(), "UTF-8");
            
            response.sendRedirect(redirectUrl);
        } catch (WxErrorException e) {
            response.sendRedirect(targetUrl + "?error=auth_failed");
        }
    }
}

3. 业务系统对接（前端）

业务系统在需要授权时，请求统一服务生成授权链接，并跳转。

前端代码示例

// 业务系统页面逻辑
function requestWechatAuth() {
  const targetUrl = encodeURIComponent('https://your-business.com/user-center');
  const authUrl = `https://auth.yourcompany.com/generate-auth-url?targetUrl=${targetUrl}`;
  
  // 跳转到微信授权页
  window.location.href = authUrl;
}