使用Google Drive API无法定位指定文件夹，获取文件URL失败

核心问题分析 #

你遇到的List<File> folders = result.getFiles();长度为0的问题，说明服务账号无法通过查询语句定位到目标文件夹，以下是针对性的排查和修复方案：

1. 修复查询语句的字符串拼接问题 #

当前代码直接拼接文件夹名称到查询语句中，如果名称包含单引号等特殊字符，会导致查询语法错误，直接返回空结果。需要对名称中的特殊字符进行转义：

private String getFileUrl(String parentFolderTitle, String fileName) throws IOException {
    // 转义文件夹名称中的单引号，避免查询语法错误
    String escapedFolderName = parentFolderTitle.replace("'", "\\'");
    // 搜索父文件夹的查询语句
    FileList result = driveService.files().list()
            .setQ("mimeType='application/vnd.google-apps.folder' and trashed=false and name='" + escapedFolderName + "'")
            .setSpaces("drive")
            .setFields("files(id, name)") // 额外返回name字段用于调试
            .execute();

    List<File> folders = result.getFiles();
    // 添加调试日志，确认查询结果
    if (folders.isEmpty()) {
        System.out.println("未找到匹配的文件夹，查询语句：" + "mimeType='application/vnd.google-apps.folder' and trashed=false and name='" + escapedFolderName + "'");
        return null;
    }

    String parentFolderId = folders.get(0).getId();
    System.out.println("找到目标文件夹ID：" + parentFolderId + "，名称：" + folders.get(0).getName());

    // 转义文件名中的单引号
    String escapedFileName = fileName.replace("'", "\\'");
    // 搜索子文件的查询语句
    result = driveService.files().list()
            .setQ("'" + parentFolderId + "' in parents and trashed=false and name='" + escapedFileName + "'")
            .setFields("files(name, webViewLink)")
            .execute();

    List<File> files = result.getFiles();
    for (File file : files) {
        if (file.getName().equals(fileName)) {
            return file.getWebViewLink();
        }
    }

    return null;
}

2. 确认服务账号的权限与共享设置 #

• 再次核对服务账号邮箱：确保共享文件夹和文件的目标邮箱是凭证文件（credentials.json）中的client_email字段值，避免共享到错误账号。
• 检查共享权限：即使设置为所有者，也要确认共享操作已生效（Google Drive共享可能有1-2分钟延迟）。

3. 验证API权限范围 #

当前使用的DriveScopes.DRIVE_FILE权限范围允许服务账号访问自己创建的文件和共享给自己的文件，理论上足够，但如果问题仍存在，可以尝试替换为更宽泛的只读权限进行测试：

GoogleCredentials credentials = GoogleCredentials.fromStream(credentialsStream)
        .createScoped(Collections.singletonList(DriveScopes.DRIVE_READONLY));

4. 排查Drive API启用状态 #

确认在Google Cloud Console中，当前项目已启用Google Drive API：

• 进入项目的API库，搜索"Google Drive API"
• 确认状态为"已启用"，若未启用则点击启用按钮

5. 调试建议 #

在代码中添加日志打印，输出以下信息：

• 服务账号的client_email（从credentials中获取）
• 最终执行的查询语句
• API返回的原始响应（可以通过result.toPrettyString()打印）

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