Spring Boot中Google OAuth2.0重定向URI配置及跳转问题排查

一、重定向URI不匹配问题排查方案 #

以下是逐一排查并解决问题的步骤：

• 严格匹配URI的大小写与格式：Google开发者控制台对重定向URI的校验严格区分大小写，且末尾斜杠必须完全一致。确认你配置的https://oauth-5.onrender.com/login/oauth2/code/google在Spring Boot的application.properties和Google控制台中完全一致，没有多余/缺失的斜杠、大小写错误（比如Code写成code）。
• 确认Render部署的实际域名：检查Render平台上应用的实际访问域名是否和配置的一致，避免部署过程中域名变更未同步到Google控制台。
• 检查Spring Boot的完整OAuth2配置：确保application.properties中的客户端重定向URI配置正确，示例如下：

  # 直接指定完整URI
  spring.security.oauth2.client.registration.google.redirect-uri=https://oauth-5.onrender.com/login/oauth2/code/google
  # 若使用占位符，需确保baseUrl指向正确域名
  # spring.security.oauth2.client.registration.google.redirect-uri={baseUrl}/login/oauth2/code/google
  

• 确认Google控制台的客户端类型：确保在Google控制台中，该客户端ID对应的是Web应用类型，重定向URI配置在「已授权的重定向URI」列表中（而非Android/iOS的配置项）。
• 清除缓存并重新部署：Render的部署缓存或Google控制台的配置缓存可能导致延迟，重新部署Spring Boot应用，保存Google控制台配置后等待2-3分钟再测试。

二、DeepLink跳转逻辑验证与优化 #

核心逻辑正确性 #

你的UserSuccessHandler中DeepLink的生成逻辑整体可行，但存在几个需要优化的细节：

• 异常处理的合理性：当前catch块直接抛出CustomException，但response.sendRedirect会抛出IOException，建议在catch中直接处理响应状态，避免异常无法反馈：

  catch (Exception e) {
      response.setStatus(HttpServletResponse.SC_INTERNAL_SERVER_ERROR);
      e.printStackTrace();
  }
  

• 新用户场景处理：当userOptional.isEmpty()时抛出404不合理，因为用户已经通过Google OAuth认证成功，应该自动创建新用户：

  if (userOptional.isEmpty()) {
      user = new Users();
      user.setEmail(email);
      user.setGitID(gitId);
      // 添加其他必要的默认属性
      repository.save(user);
  } else {
      user = userOptional.get();
  }
  

• 参数URL编码：accessToken可能包含特殊字符，需进行URL编码避免参数解析错误：

  import java.net.URLEncoder;
  import java.nio.charset.StandardCharsets;
  
  // ...
  
  String encodedToken = URLEncoder.encode(accessToken, StandardCharsets.UTF_8);
  String deepLink = String.format("myapp://page2?token=%s&uid=%s", encodedToken, user.getId());
  

• 日志替换：把System.out.println替换为SLF4J日志框架，方便生产环境排查问题：

  import org.slf4j.Logger;
  import org.slf4j.LoggerFactory;
  
  private static final Logger logger = LoggerFactory.getLogger(UserSuccessHandler.class);
  
  // ...
  
  logger.info("Generated deep link: {}", deepLink);
  logger.info("Access token: {}", accessToken);
  

客户端跳转验证 #

• 确认客户端（Android/iOS/桌面应用）已注册myapp Scheme，且能正确解析page2路径以及token、uid参数。
• 测试时可直接在浏览器中输入生成的DeepLink，验证是否能唤起客户端并正确获取参数。

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