需通过OAuth授权与绑定接口实现SOFA账号与微信、QQ等第三方社交账号关联：一、启用社交登录配置；二、前端调用SDK获取code；三、后端用code换OpenID并调用绑定接口；四、处理绑定冲突；五、验证绑定结果并同步用户资料。
如果您正在使用SOFA平台并希望将用户账号与微信、QQ等第三方社交平台账号建立关联，则需通过标准的OAuth授权与绑定接口完成身份映射。以下是实现SOFA绑定第三方社交账号的具体操作流程：
一、确认SOFA平台已启用社交登录配置
SOFA平台需预先在管理后台开启对应社交平台的登录支持，并完成App ID与Secret的登记，否则前端无法发起授权请求，后端也无法校验回调参数。
1、登录SOFA多端应用控制台，进入「身份管理」→「社交登录」模块。
2、勾选「微信登录」「QQ登录」等目标平台选项。
3、分别填写各平台提供的App ID 和 App Secret，其中微信网页端需使用微信开放平台申请的凭证，QQ需使用QQ互联平台下发的凭证。
4、保存配置，确保状态显示为「已启用」。
二、前端调用社交授权SDK触发登录流程
用户在SOFA客户端（Web/H5/小程序）点击微信或QQ图标时，需由前端SDK拉起对应平台的OAuth授权页，获取一次性code，该code是后续换取用户标识的唯一凭据。
1、在页面中引入SOFA官方提供的登录组件或调用sofa.auth.login({ provider: 'weixin' })方法。
2、用户点击微信图标后，跳转至微信OAuth2.0授权地址，URL中携带redirect_uri参数，该地址必须与后台配置的回调域名完全一致。
3、用户确认授权后，微信服务端重定向至redirect_uri?code=xxx&state=yyy，前端需完整捕获该URL并提取code参数值。
4、同理，QQ登录需调用sofa.auth.login({ provider: 'qq' })，并捕获其返回的code。
三、后端使用code换取用户OpenID并执行绑定
前端将code提交至SOFA服务端绑定接口，服务端需立即向对应平台接口换token和用户信息，验证合法性后建立账号绑定关系，避免code重复使用或过期失效。
1、向微信接口https://api.weixin.qq.com/sns/oauth2/access_token发送POST请求，携带appid、secret、code、grant_type=authorization_code参数。
2、解析返回JSON，提取openid与unionid（若公众号/开放平台已绑定），并校验errcode字段是否为0。
3、调用SOFA绑定接口POST /v1/user/bind/thirdparty，Body中传入{"provider":"weixin","openid":"oXXX","unionid":"UXXX","access_token":"xxx"}。
4、对QQ登录，调用https://graph.qq.com/oauth2.0/token获取access_token，再调用https://graph.qq.com/oauth2.0/me获取openid，同样提交至SOFA绑定接口，provider设为qq。
四、处理已存在账号冲突场景
当第三方平台返回的openid已被其他SOFA用户绑定时，系统需拒绝直接覆盖，而应返回明确错误码并交由前端引导用户选择解绑或取消操作，防止身份误关联。
1、SOFA绑定接口返回409 Conflict及error_code: "BINDING_CONFLICT"时，前端展示提示：“该微信账号已被其他SOFA账户绑定”。
2、提供两个可选操作按钮：“解绑原账号并重新绑定”与“取消当前绑定”。
3、若用户选择解绑，前端调用DELETE /v1/user/bind/thirdparty?provider=weixin&openid=xxx，成功后再重试绑定流程。
4、解绑操作需校验当前会话用户是否具备该原账号的管理权限，否则返回403 Forbidden。
五、验证绑定结果并同步用户资料
绑定成功后，SOFA需主动拉取第三方平台最新用户基础信息（昵称、头像、性别等），更新本地用户档案，确保后续服务可基于统一身份展开。
1、调用SOFA接口GET /v1/user/bind/info?provider=weixin，确认绑定状态为bound且last_sync_time非空。
2、根据返回的access_token，调用微信接口https://api.weixin.qq.com/sns/userinfo获取用户公开资料。
3、提取nickname与headimgurl字段，调用SOFA资料更新接口PATCH /v1/user/profile，仅更新未手动修改过的字段。
4、对QQ用户，调用https://graph.qq.com/user/get_user_info，传入access_token与oauth_consumer_key，解析返回JSON中的nickname和figureurl_qq_2字段进行同步。
