Android应用如何加载展示Firebase Storage存储的用户头像图片？

核心错误点 #

• 初始代码存储的是头像文件名（xxx.jpg）而非可访问的网络链接，Picasso无法加载本地文件名作为图片源
• 后续尝试存下载链接时，获取下载链接的方式错误：task.getResult().getStorage().getDownloadUrl().toString()拿到的是Task对象的字符串描述，不是真实的图片访问地址，因为getDownloadUrl()本身是异步任务，需要监听回调才能拿到真实Uri
• 可选排查点：未配置正确的Storage权限、应用网络权限，或Picasso加载时缺少错误处理无法定位问题

修复步骤 #

第一步：正确获取并存储下载链接 #

修改onActivityResult中上传成功后的代码，替换原来的downloadUrl获取逻辑：

filePath.putFile(resultUri).addOnCompleteListener(new OnCompleteListener<UploadTask.TaskSnapshot>() {
    @Override
    public void onComplete(@NonNull Task<UploadTask.TaskSnapshot> task) {
        if (task.isSuccessful()){
            // 正确监听getDownloadUrl的异步回调
            filePath.getDownloadUrl().addOnSuccessListener(new OnSuccessListener<Uri>() {
                @Override
                public void onSuccess(Uri uri) {
                    String downloadUrl = uri.toString();
                    // 存储真实的下载链接到数据库
                    UsersRef.child("profileimage").setValue(downloadUrl)
                        .addOnCompleteListener(new OnCompleteListener<Void>() {
                            @Override
                            public void onComplete(@NonNull Task<Void> task) {
                                if(task.isSuccessful()){
                                    Toast.makeText(ProfileActivity.this, "头像存储成功", Toast.LENGTH_SHORT).show();
                                    loadingBar.dismiss();
                                }
                                else {
                                    String message = task.getException().getMessage();
                                    loadingBar.dismiss();
                                    Toast.makeText(ProfileActivity.this, "存储出错：" + message, Toast.LENGTH_SHORT).show();
                                }
                            }
                        });
                }
            }).addOnFailureListener(new OnFailureListener() {
                @Override
                public void onFailure(@NonNull Exception e) {
                    loadingBar.dismiss();
                    Toast.makeText(ProfileActivity.this, "获取下载链接失败：" + e.getMessage(), Toast.LENGTH_SHORT).show();
                }
            });
        } else {
            loadingBar.dismiss();
            Toast.makeText(ProfileActivity.this, "上传失败：" + task.getException().getMessage(), Toast.LENGTH_SHORT).show();
        }
    }
});

第二步：优化Picasso加载逻辑，添加错误排查 #

修改图片加载的代码段，添加占位图和错误回调方便定位问题：

if (snapshot.hasChild("profileimage")) {
    String image = snapshot.child("profileimage").getValue().toString();
    // 可打印日志确认image是否为http/https开头的有效链接
    Log.d("ProfileImageUrl", image);
    Picasso.get()
        .load(image)
        .placeholder(R.drawable.default_avatar) // 替换为项目内的默认头像资源
        .error(R.drawable.error_avatar) // 替换为加载失败时显示的资源
        .into(Profileimage, new Callback() {
            @Override
            public void onSuccess() {
                Log.d("Picasso", "加载成功");
            }

            @Override
            public void onError(Exception e) {
                Log.e("Picasso", "加载失败：" + e.getMessage());
            }
        });
}

第三步：排查权限配置 #

• 确认AndroidManifest.xml中已添加网络权限：<uses-permission android:name="android.permission.INTERNET" />
• 确认Firebase Storage的规则已放开对应目录的读权限，测试阶段可临时设置为：

rules_version = '2';
service firebase.storage {
  match /b/{bucket}/o {
    match /Profile Images/{allPaths=**} {
      allow read, write: if request.auth != null;
    }
  }
}

内容的提问来源于stack exchange，提问作者Daniele Rossi