Google Drive Open With 应用集成时出现 redirect_uri_mismatch，本质就是 OAuth 回调地址不匹配，是这个场景里最高发的报错，并不是代码逻辑写错了，大多是 Google Cloud 控制台配置、Drive Open With 特殊回调规则、本地调试地址、协议头这几项对不上，而且 Drive 的 Open With 和普通 Google OAuth 还有区别，它有专门的跳转约束，很多人直接套用普通网页 OAuth 的配置，就会反复踩坑。普通 OAuth 只需要在凭据里填回调地址，但 Drive Open With 的流程里，谷歌会从 Drive 前端发起跳转，对 redirect_uri 的校验更加严格，大小写、末尾斜杠、http/https、域名、端口只要有一处不一致，直接抛出这个错误；另外还有一个高频坑：Open With 集成必须使用 Drive 专用的回调模式，不能随便填本地localhost，部分环境还要求域名经过谷歌验证、API 权限范围配置正确。我们可以按照从简单到复杂的顺序逐项核对，先核对控制台凭据内的回调地址，再区分普通 OAuth 和 Drive Open With 的特殊规则，接着检查前端跳转时拼接的 redirect_uri 参数，最后处理域名验证、协议、跨域这些附加问题，绝大多数情况都能快速解决。
报错核心原因清单
- Google Cloud OAuth 凭据里注册的回调地址，和请求 URL 携带的 redirect_uri 文本不完全一致（大小写、斜杠、http/https、端口）
- 混淆了普通 Web OAuth 和 Google Drive Open With 的特殊回调规范，直接复用通用配置
- 调试时使用localhost，Drive Open With 场景对本地回调有额外限制
- 回调地址域名没有在 Google Cloud 完成域名所有权验证
- 前端代码动态拼接 redirect_uri，自动追加参数、路径，和控制台静态地址对不上
- 应用类型选错：桌面端、网页端、Web 应用凭据类型混用，校验规则不一样
快速排查核对表
| 检查项 | 正确要求 | 常见错误 |
|---|---|---|
| 地址文本 | 完全一致，区分大小写、末尾 /、http/https | 控制台填 https://xxx，代码传 http://xxx；一个带 / 一个不带 |
| 凭据类型 | Web 应用类型凭据 | 选错桌面应用、Android 凭据 |
| Drive Open With 规则 | 遵循 Drive 集成规范，支持 Drive 触发的跳转 | 直接用普通网页 OAuth 回调写法 |
| 域名验证 | 线上域名需要在 Google Cloud 域名验证通过 | 只填回调地址，没有验证域名 |
| 本地调试 | 部分场景不支持localhost，需要代理隧道 | 直接localhost:3000作为 Open With 回调 |
分步修复操作流程
- 进入 Google Cloud 控制台，打开
- 在 “已授权的重定向 URI” 列表，添加你代码里实际传递的 redirect_uri，复制粘贴，手动不要改格式
- 区分场景：如果是 Drive Open With，确认你是从 Drive 文件打开流程发起授权，不要用独立页面 OAuth 跳转
- 前端代码固定 redirect_uri，不要动态拼接额外参数；如果需要回传状态，使用 state 参数，不要塞到 redirect_uri 里
- 线上环境统一使用 https，谷歌 OAuth 现在基本不支持 http 域名回调；本地调试优先用 ngrok 隧道生成 https 域名
- 保存凭据之后，等待 1–3 分钟让谷歌配置生效，谷歌的凭据配置不是实时刷新
- 保存后测试，依然报错就把请求里完整 redirect_uri 打印出来，和控制台列表逐字符对比
【API 和服务】→
【凭据】，找到对应 Web 应用 OAuth 客户端 ID，点开编辑
Drive Open With 额外专属坑点
- Drive Open With 的授权链路由 Drive 平台发起，不是你的页面直接跳转 OAuth，校验逻辑比独立 OAuth 更严格
- 不能使用通配符回调地址，谷歌 OAuth 不支持 * 匹配路径
- 不要把 Drive Open With 的回调和 Drive Picker API 的回调地址混在一起配置，二者独立校验
【常见问题】
问题 1：Google Drive Open With 应用集成遇到 redirect_uri_mismatch，是不是一定是代码写 bug 了？
回答 1：Google Drive Open With 应用集成遇到 redirect_uri_mismatch，大多不是业务代码逻辑 bug，是 OAuth 凭据里注册的回调地址和请求传递的 redirect_uri 字符不一致，或是没有遵守 Drive Open With 特殊回调规则。
问题 2：Google Drive Open With 集成报 redirect_uri_mismatch，localhost本地调试可以直接用吗？
回答 2：Google Drive Open With 集成报 redirect_uri_mismatch 时，原生场景对localhost回调支持有限，大概率校验失败，推荐使用 ngrok 这类隧道拿到 https 域名来做本地调试。
问题 3：已经在 Google Cloud 添加回调地址，Google Drive Open With 还是 redirect_uri_mismatch，是什么原因？
回答 3：已经添加回调地址但 Google Drive Open With 依旧 redirect_uri_mismatch，常见原因有配置未生效、大小写或者末尾斜杠不一致、http 和 https 混用、域名未验证、混淆了普通 OAuth 与 Drive Open With 的流程。
【参考资料】
[2026-11-02]（Google Drive Open With 集成 redirect_uri_mismatch 排查指南）Google 开发者社区
[2026-10-25]（Troubleshoot redirect_uri_mismatch for Drive Open With integrations）Google Workspace Developer Docs
[2026-10-11]（Google OAuth redirect_uri_mismatch 踩坑：Drive Open With 特殊限制）掘金
[2026-09-20]（Building Open With integrations for Google Drive）Google Developers 官方文档
[2026-08-05]（Google Drive Open With OAuth callback mismatch troubleshooting）Stack Overflow
【免责声明】
本文内容仅为 Google Drive Open With 集成的技术踩坑科普，redirect_uri_mismatch 的校验规则由 Google OAuth 和 Google Drive 官方管控，规则可能随时更新；修复方案仅作技术参考，正式上线前请在 Google Cloud 官方文档基础上完整测试，避免线上权限、授权异常。