HWIOAuthBundle发送HTTP请求时出错问题求助

我之前在使用Symfony 2.8 + HWIOAuthBundle 0.4.*@dev + FOSUserBundle ~2.0的组合时，也碰到过一模一样的问题——首次点击社交登录会抛出HttpTransportException，但返回页面再点一次就完全正常，而且多个授权提供商都有这个情况。结合当时的排查经验，给你几个可行的解决方案：

1. 检查会话存储配置与权限 #

这个问题最常见的根源是首次请求时会话未正确初始化，导致OAuth的状态参数无法持久化，进而触发后续的HTTP请求失败。

• 打开app/config/config.yml，确认会话配置的存储路径存在且有读写权限：

  framework:
      session:
          handler_id: ~
          save_path: "%kernel.root_dir%/var/sessions/%kernel.environment%"
          cookie_lifetime: 3600
  

  手动创建var/sessions/dev（对应你的运行环境）目录，并设置权限为775或者让Web服务器用户拥有读写权限。很多时候首次请求时这个目录不存在，会话无法写入，直接导致OAuth状态丢失。

2. 修复HWIOAuthBundle的状态存储bug #

HWIOAuthBundle 0.4.*@dev版本有个已知的小问题：首次请求时，OAuth的CSRF状态参数没有被正确存入会话，导致跳转回回调URL时验证失败，进而抛出HTTP传输异常（本质是状态验证失败后中断了用户信息请求）。

你可以通过自定义ResourceOwner来强制存储状态参数：

• 创建自定义ResourceOwner类（以Facebook为例，其他提供商类似）：

  // src/AppBundle/OAuth/ResourceOwner/CustomFacebookResourceOwner.php
  namespace AppBundle\OAuth\ResourceOwner;
  
  use HWI\Bundle\OAuthBundle\OAuth\ResourceOwner\FacebookResourceOwner;
  use Symfony\Component\HttpFoundation\Request;
  
  class CustomFacebookResourceOwner extends FacebookResourceOwner
  {
      public function getAuthorizationUrl(Request $request, $redirectUri = null)
      {
          // 手动生成并存储CSRF状态
          $state = $this->getCsrfToken();
          $this->session->set('_hwi_oauth_state', $state);
  
          return parent::getAuthorizationUrl($request, $redirectUri);
      }
  }
  

• 在config.yml里替换默认的ResourceOwner：

  hwi_oauth:
      resource_owners:
          facebook:
              type: custom_facebook
              class: AppBundle\OAuth\ResourceOwner\CustomFacebookResourceOwner
              client_id: "%facebook_client_id%"
              client_secret: "%facebook_client_secret%"
              scope: "email"
  

  其他提供商如Google、Twitter也可以用同样的方式自定义。

3. 调整HTTP客户端超时配置 #

首次请求时可能因为网络延迟或者授权提供商的响应慢导致超时，进而触发HttpTransportException。你可以在HWIOAuthBundle配置里增加超时时间：

hwi_oauth:
    http_client:
        timeout: 10 # 把超时时间从默认的几秒增加到10秒
        # 本地开发环境可以临时关闭SSL验证，生产环境请删除这行
        verify_peer: false

4. 确认FOSUserBundle集成配置 #

确保HWIOAuthBundle和FOSUserBundle的桥接配置正确，避免首次创建用户时的会话冲突：

• 检查security.yml里的OAuth用户提供者配置：

  security:
      firewalls:
          main:
              oauth:
                  oauth_user_provider:
                      service: hwi_oauth.user.provider.fosub_bridge
              # 其他防火墙配置...
      providers:
          fos_userbundle:
              id: fos_user.user_provider.username_email
  

• 检查config.yml里的FOSUB关联配置：

  hwi_oauth:
      fosub:
          username_iterations: 30
          properties:
              facebook: facebookId # 对应你用户实体里存储Facebook ID的字段
              google: googleId # 对应Google ID的字段
  

以上几个方案你可以逐个尝试，我当时是通过修复会话存储路径权限+自定义ResourceOwner解决的问题。

内容的提问来源于stack exchange，提问作者shuba.ivan