「用微信登錄」幾乎成了國內 App 的標配。它背後走的是 OAuth 2.0 授權流程,但真正落地時,卡住開發者的往往不是協議本身,而是配置、ATS、token 續期這些工程細節。本文按接入順序把整個過程走一遍。
移動應用微信登錄建立在 OAuth 2.0 標準之上。正式動工前需要完成三件事:在微信開放平台註冊開發者帳號、讓你的移動應用通過審核、拿到對應的 AppID 與 AppSecret,並單獨申請「微信登錄」能力。這一步沒走完,後面寫什麼都是白費。
從微信開放平台下載 iOS 版 SDK。

把 SDK 放到工程目錄中,建議單獨建一個文件夾管理。

SDK 依賴一批系統框架,逐一加入即可。

微信回跳靠 URL Scheme 完成,這裡要填寫你在開放平台註冊時的 AppID。


這一步最容易被跳過,跳過之後運行時就會看到:
-canOpenURL: failed for URL: "weixin://app/wx9**********dfd30/" - error: "This app is not allowed to query for scheme weixin"
iOS 9 引入 ATS,預設要求所有網路請求走 TLS 1.2 以上。需要在 Info.plist 中顯式聲明例外:
<key>NSAppTransportSecurity</key>
<dict>
<key>NSAllowsArbitraryLoads</key>
<true/>
</dict>

若不做這項配置,直接發起 HTTP 請求會被系統攔截:
App Transport Security has blocked a cleartext HTTP (https://) resource load since it is insecure. Temporary exceptions can be configured via your app's Info.plist file.
在 AppDelegate.m 引入 WXApi.h,完成兩件事:啟動時註冊 App,以及攔截從微信返回的 URL。
#import "AppDelegate.h"
#import "LoginViewController.h"
#import "WXApi.h"
- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
[WXApi registerApp:@"wxd1931d4a0e46****" withDescription:@"Wechat"];
return YES;
}
// 從微信返回第三方 App
- (BOOL)application:(UIApplication *)application
handleOpenURL:(NSURL *)url
{
[WXApi handleOpenURL:url delegate:self];
return YES;
}
SDK 接入正確並取得相應 scope 權限後,App 會在本地喚起微信完成授權;用戶確認,微信再帶著一次性 code 跳回你的 App。
這裡有個審核相關的硬性要求:微信登錄是用戶必須先安裝微信才能用。因此點擊前應先用 isWXAppInstalled 判斷,未安裝就把入口藏起來,只留其他登錄方式。
- (IBAction)wechatLoginClick:(id)sender
{
if ([WXApi isWXAppInstalled]) {
SendAuthReq *req = [[SendAuthReq alloc] init];
req.scope = @"snsapi_userinfo";
req.state = @"App";
[WXApi sendReq:req];
} else {
[self setupAlertController];
}
}
- (void)setupAlertController
{
UIAlertController *alert = [UIAlertController
alertControllerWithTitle:@"溫馨提示"
message:@"請先安裝微信客戶端"
preferredStyle:UIAlertControllerStyleAlert];
[alert addAction:[UIAlertAction actionWithTitle:@"確定"
style:UIAlertActionStyleDefault
handler:nil]];
[self presentViewController:alert animated:YES completion:nil];
}

access_token 只有 2 小時壽命,refresh_token 則有 30 天。合理的策略是:本地存下 token,下次進來先用 refresh_token 換新的,換不到才走完整授權。
- (IBAction)wechatLoginClick:(id)sender
{
NSString *accessToken = [[NSUserDefaults standardUserDefaults] objectForKey:WX_ACCESS_TOKEN];
NSString *openID = [[NSUserDefaults standardUserDefaults] objectForKey:WX_OPEN_ID];
if (accessToken && openID) {
AFHTTPRequestOperationManager *manager = [AFHTTPRequestOperationManager manager];
NSString *refreshToken = [[NSUserDefaults standardUserDefaults] objectForKey:WX_REFRESH_TOKEN];
NSString *refreshUrlStr = [NSString stringWithFormat:
@"%@/oauth2/refresh_token?appid=%@&grant_type=refresh_token&refresh_token=%@",
WX_BASE_URL, WXPatient_App_ID, refreshToken];
[manager GET:refreshUrlStr parameters:nil success:^(AFHTTPRequestOperation *operation, id responseObject) {
NSDictionary *refreshDict = [NSDictionary dictionaryWithDictionary:responseObject];
NSString *reAccessToken = [refreshDict objectForKey:WX_ACCESS_TOKEN];
if (reAccessToken) {
// 續期成功,更新本地三件套
[[NSUserDefaults standardUserDefaults] setObject:reAccessToken forKey:WX_ACCESS_TOKEN];
[[NSUserDefaults standardUserDefaults] setObject:[refreshDict objectForKey:WX_OPEN_ID] forKey:WX_OPEN_ID];
[[NSUserDefaults standardUserDefaults] setObject:[refreshDict objectForKey:WX_REFRESH_TOKEN] forKey:WX_REFRESH_TOKEN];
[[NSUserDefaults standardUserDefaults] synchronize];
!self.requestForUserInfoBlock ?: self.requestForUserInfoBlock();
} else {
[self wechatLogin]; // 連 refresh_token 也過期了
}
} failure:^(AFHTTPRequestOperation *operation, NSError *error) {
NSLog(@"刷新 accessToken 出錯 = %@", error);
}];
} else {
[self wechatLogin];
}
}
refresh_token 的兩種行為值得記住:
讓 AppDelegate 遵守 <WXApiDelegate> 並實作 onResp:,在這裡接住 code。
- (void)onResp:(BaseResp *)resp
{
if ([resp isKindOfClass:[SendAuthResp class]]) {
SendAuthResp *temp = (SendAuthResp *)resp;
// ErrCode == 0 表示用戶同意,此時 code 才有效
AFHTTPRequestOperationManager *manager = [AFHTTPRequestOperationManager manager];
NSString *accessUrlStr = [NSString stringWithFormat:
@"%@/oauth2/access_token?appid=%@&secret=%@&code=%@&grant_type=authorization_code",
WX_BASE_URL, WXPatient_App_ID, WXPatient_App_Secret, temp.code];
[manager GET:accessUrlStr parameters:nil success:^(AFHTTPRequestOperation *operation, id responseObject) {
NSDictionary *accessDict = [NSDictionary dictionaryWithDictionary:responseObject];
NSString *accessToken = [accessDict objectForKey:WX_ACCESS_TOKEN];
NSString *openID = [accessDict objectForKey:WX_OPEN_ID];
NSString *refreshToken = [accessDict objectForKey:WX_REFRESH_TOKEN];
if (accessToken.length && openID.length) {
[[NSUserDefaults standardUserDefaults] setObject:accessToken forKey:WX_ACCESS_TOKEN];
[[NSUserDefaults standardUserDefaults] setObject:openID forKey:WX_OPEN_ID];
[[NSUserDefaults standardUserDefaults] setObject:refreshToken forKey:WX_REFRESH_TOKEN];
[[NSUserDefaults standardUserDefaults] synchronize]; // 立即落盤,避免資料丟失
}
[self wechatLoginByRequestForUserInfo];
} failure:^(AFHTTPRequestOperation *operation, NSError *error) {
NSLog(@"獲取 access_token 出錯 = %@", error);
}];
}
}
回調中幾個欄位的含義:
ErrCode:0 为用户同意、-4 拒絕、-2 取消。code:換取 access_token 的一次性票據,僅在 ErrCode 為 0 時有效。state:請求唯一標識,由 sendReq 傳入並原樣回傳,長度上限 1K。GET https://api.weixin.qq.com/sns/oauth2/access_token?appid=APPID&secret=SECRET&code=CODE&grant_type=authorization_code
四個參數均為必填:appid 與 secret 來自開放平台,code 是上一步拿到的臨時票據,grant_type 固定填 authorization_code。
成功時的響應結構:
{
"access_token": "ACCESS_TOKEN",
"expires_in": 7200,
"refresh_token": "REFRESH_TOKEN",
"openid": "OPENID",
"scope": "SCOPE",
"unionid": "o6_bmasdasdsad6_2sgVt7hMZOPfL"
}
失敗則是 {"errcode":40029,"errmsg":"invalid code"},通常意味著 code 已被使用或已過期。
GET https://api.weixin.qq.com/sns/userinfo?access_token=ACCESS_TOKEN&openid=OPENID
- (void)wechatLoginByRequestForUserInfo
{
AFHTTPRequestOperationManager *manager = [AFHTTPRequestOperationManager manager];
NSString *accessToken = [[NSUserDefaults standardUserDefaults] objectForKey:WX_ACCESS_TOKEN];
NSString *openID = [[NSUserDefaults standardUserDefaults] objectForKey:WX_OPEN_ID];
NSString *userUrlStr = [NSString stringWithFormat:@"%@/userinfo?access_token=%@&openid=%@",
WX_BASE_URL, accessToken, openID];
[manager GET:userUrlStr parameters:nil success:^(AFHTTPRequestOperation *operation, id responseObject) {
NSLog(@"用戶信息 = %@", responseObject);
// 在這裡把 nickname / headimgurl 等寫入自己的帳號體系
} failure:^(AFHTTPRequestOperation *operation, NSError *error) {
NSLog(@"獲取用戶信息出錯 = %@", error);
}];
}
返回的 JSON 包含 openid、nickname、sex、province、city、country、headimgurl、privilege 與 unionid。其中 unionid 只有在把公眾號綁定到微信開放平台帳號後才會出現,它是跨應用識別同一用戶的關鍵。
把散落的字串收攏成宏,後續維護會輕鬃很多:
#define WXDoctor_App_ID @"wxd1931d4a0e462***" #define WXDoctor_App_Secret @"d0dd6b58da42cbc4f4b715c70e65c***" #define WXPatient_App_ID @"wxbd02bfeea4292***" #define WXPatient_App_Secret @"4a788217f363358276309ab655707***" #define WX_ACCESS_TOKEN @"access_token" #define WX_OPEN_ID @"openid" #define WX_REFRESH_TOKEN @"refresh_token" #define WX_UNION_ID @"unionid" #define WX_BASE_URL @"https://api.weixin.qq.com/sns"
注意:AppSecret 屬於敏感憑證,正式項目中不要硬編碼在用戶端,也不建議提交進版本庫。
拿到微信身份只是完成了一半,真正要做的是把它接到自己的帳號體系上。一種常見的落地流程:
這樣設計的好處是,微信只是「身份來源」,帳號歸屬仍舊掌握在自己的手機號體系裡,後續換第三方登錄方式也不會傷筋動骨。