Google Drive API V3：含空格文件夹查询失败，如何正确转义查询参数？

我之前也踩过Google Drive API查询带空格文件夹的坑，给你几个实用的排查和解决思路：

1. 避免手动编码，让工具自动处理URL编码 #

你提到用了url.QueryEscape或url.PathEscape但没解决，很大概率是双重编码导致的问题：API Explorer会自动对整个查询参数做正确编码，而如果你手动编码了名称字段，再把它拼进查询语句里，后续HTTP请求库可能又会对整个查询串再编码一次，导致空格被转成%2520（也就是%20又被编码了一次），这就会让API识别不到正确的文件夹名称。

举个Go语言的错误示例和修正方案：

• 错误做法（手动编码+直接拼接）：

encodedName := url.QueryEscape("07 Dirname")
query := fmt.Sprintf("name='%s' and mimeType='application/vnd.google-apps.folder' and '0B22uLx7BCvv9T0FWRmNaREY4VEE' in parents and trashed=false", encodedName)
url := fmt.Sprintf("https://www.googleapis.com/drive/v3/files?q=%s", query)

• 正确做法（用url.Values自动处理整个查询参数）：

params := url.Values{}
params.Set("q", "name='07 Dirname' and mimeType='application/vnd.google-apps.folder' and '0B22uLx7BCvv9T0FWRmNaREY4VEE' in parents and trashed=false")
fullUrl := "https://www.googleapis.com/drive/v3/files?" + params.Encode()

这种方式会让url.Values自动对整个q参数做标准URL编码，完全避免手动编码带来的问题。

2. 对比API Explorer的实际请求 #

打开API Explorer的浏览器开发者工具（F12），查看它发送请求时q参数的编码结果，比如你这个查询的正确编码应该是：
name%3D%2707%20Dirname%27%20and%20mimeType%3D%27application%2Fvnd.google-apps.folder%27%20and%20%270B22uLx7BCvv9T0FWRmNaREY4VEE%27%20in%20parents%20and%20trashed%3Dfalse
把这个编码后的字符串直接放到你的代码里测试，如果能成功，就说明你之前的编码逻辑有误，应该用工具处理整个查询串的编码，而非单独处理名称字段。

3. 排查查询语句的语法细节 #

虽然你说无空格时正常，但还是可以确认下：

• 名称的单引号是否正确包裹，有没有遗漏或多写
• 父文件夹ID的单引号是否正确（你这里看起来是对的）
• 确保mimeType的拼写完全正确，没有大小写错误

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