Android集成Google登录调用getPhotoUrl()返回null，无法获取用户头像

我之前也遇到过一模一样的情况——明明已经设置了账号头像、加了requestProfile()，但getPhotoUrl()就是返回null。下面是几个亲测有效的解决办法，你可以逐一尝试：

1. 显式添加Profile权限Scope #

虽然requestProfile()理论上已经包含了获取头像的权限，但有时候显式声明Scope能解决这个问题。修改你的GoogleSignInOptions代码：

GoogleSignInOptions gso = new GoogleSignInOptions.Builder(GoogleSignInOptions.DEFAULT_SIGN_IN)
        .requestEmail()
        .requestProfile()
        .requestScopes(new Scope("https://www.googleapis.com/auth/userinfo.profile")) // 显式添加Profile scope
        .build();

重新编译运行后，再试试获取头像。

2. 使用People API获取头像（更可靠的方案） #

有时候GoogleSignInAccount.getPhotoUrl()会因为缓存或者账号同步问题返回null，这时候调用Google People API能更稳定地获取用户头像信息。

步骤1：添加People API依赖 #

在你的app级build.gradle文件中添加依赖：

implementation 'com.google.android.gms:play-services-people:17.0.0'

步骤2：修改登录成功后的处理逻辑 #

替换原来的头像获取代码，改用People API请求：

private void handleSignInResult(Task<GoogleSignInAccount> completedTask) {
    try {
        GoogleSignInAccount account = completedTask.getResult(ApiException.class);
        String googleName = account.getDisplayName();
        String googleEmail = account.getEmail();
        
        // 调用People API获取用户详细信息（包括头像）
        PeopleApi.getPerson(account, null)
                .addOnSuccessListener(person -> {
                    Uri photoUrl = null;
                    if (person.hasPhotos()) {
                        // 获取头像URL，还可以修改sz参数调整尺寸（比如sz=200）
                        String rawPhotoUrl = person.getPhotos().get(0).getUrl().replace("sz=50", "sz=200");
                        photoUrl = Uri.parse(rawPhotoUrl);
                        Log.w(TAG, "People API 获取头像URL: " + photoUrl);
                    }
                    // 传递数据到Presenter
                    mainPresenter.dataSocialAPI(googleName, googleEmail, userType);
                    signOut();
                })
                .addOnFailureListener(e -> {
                    Log.w(TAG, "获取用户信息失败: ", e);
                    // 失败时 fallback 到原方法
                    Uri photoUrl = account.getPhotoUrl();
                    Log.w(TAG, "原方法获取头像URL: " + photoUrl);
                    mainPresenter.dataSocialAPI(googleName, googleEmail, userType);
                    signOut();
                });
        
    } catch (ApiException e) {
        Log.w(TAG, "signInResult:failed code=" + e.getStatusCode());
    }
}

步骤3：在Google Cloud Console启用People API #

登录你的Google Cloud Console，找到当前项目，进入「API和服务」→「启用API和服务」，搜索「People API」并启用它。否则调用People API会返回权限错误。

3. 确认账号头像的有效性 #

虽然你说已经设置了头像，但可以再确认一下：登录你的Google账号，进入「个人资料」页面，确保头像已经成功保存为账号的主头像（有些情况下，用户可能在特定产品里设置了头像，但主账号头像未同步）。

内容的提问来源于stack exchange，提问作者Marcus Barnet