Vtiger 7.1 Active Directory认证成功后跳转回登录页求助

我之前帮客户部署Vtiger 7.1的时候刚好碰到过一模一样的问题——AD认证逻辑明明返回成功，但页面就是卡在登录页，死活跳不到系统首页。结合当时的排查过程，给你几个亲测有效的排查方向：

• 检查本地用户角色配置
  Vtiger 7.1对用户权限的校验比6.5严格很多，哪怕AD认证通过，如果对应的Vtiger本地用户没有分配有效的角色（比如默认的「Employee」角色），系统会默默拒绝跳转。你可以先尝试用管理员账号登录后台，手动创建一个和AD用户名完全一致的本地用户，给它分配基础角色后，再用AD账号登录试试。

• 验证AD属性映射配置
  7.1版本的LDAP/AD属性映射规则有更新，要是username、email这些核心字段映射错误，或者AD里对应的属性为空，系统会在认证后因为用户信息不完整而触发跳转回登录页的逻辑。你可以检查config/ldap.php（如果没有就复制config/ldap.php.sample并重命名）里的字段映射：

  $ldap_field_map = array(
      'username' => 'sAMAccountName',
      'email' => 'mail',
      'first_name' => 'givenName',
      'last_name' => 'sn'
  );
  

  确保这些AD属性在你的域环境里是存在且有有效值的。

• 清空系统与浏览器缓存
  Vtiger 7.1的缓存机制比旧版本激进，有时候配置修改后缓存没清会导致逻辑异常。你可以：

  • 若能通过本地管理员账号进入后台，前往【设置】→【系统】→【缓存管理】，清空所有缓存；
  • 手动删除服务器上cache/目录下的所有文件（注意保留cache/目录本身）；
  • 清除浏览器的Cookie和缓存，尤其是Vtiger相关的会话Cookie。

• 检查PHP会话与站点URL配置
  服务器的PHP会话配置（比如session.cookie_domain、session.cookie_secure）和Vtiger的site_URL不匹配时，会导致认证成功后会话无法正常保存，最终跳回登录页。你可以确认config.php里的$site_URL是否和实际访问的域名完全一致；另外检查PHP的php.ini中session.save_path是否有写入权限。

• 查看系统日志定位具体错误
  很多时候表面上是跳转问题，背后有隐藏的错误。你可以打开config.php，将$DEBUG_MODE设为true，然后尝试AD登录，之后查看logs/vtigercrm.log文件，里面大概率会记录认证成功后跳转失败的具体原因（比如某个用户字段缺失、权限校验不通过等）。

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