Symfony 2.8集成FR3DLdapBundle与FOSUserBundle时SQL报错

看起来你的问题核心是LDAP登录集成没有正确检测本地数据库中已存在的用户，导致每次登录都执行INSERT操作而非UPDATE，触发了email_canonical字段的唯一约束冲突。

先看一下你遇到的具体错误：

执行INSERT INTO fos_user (username, username_canonical, email, email_canonical, enabled, salt, password, last_login, confirmation_token, password_requested_at, roles, dn, code_utilisateur) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)语句，参数为["riemann", "riemann", "riemann@ldap.forumsys.com", "riemann@ldap.forumsys.com", 1, null, "", "2018-05-23 21:26:15", null, null, "a:1:{i:0;s:9:\"ROLE_USER\";}", "uid=riemann,dc=example,dc=com", null]时发生异常：SQLSTATE[23000]: Integrity constraint violation: 1062 Duplicata du champ 'riemann@ldap.forumsys.com' pour la clef 'UNIQ_957A6479A0D96FBF'

这个错误明确说明：数据库里已经存在邮箱为riemann@ldap.forumsys.com的用户，但你的登录流程没有检测到这一点，直接尝试创建新用户，导致唯一键冲突。

下面是具体的解决步骤：

1. 检查FOSUserBundle与LDAP的基础配置 #

确保你在Symfony的security.yaml和fos_user.yaml中正确配置了LDAP用户提供者，并且开启了用户更新逻辑：

security.yaml示例配置： #

security:
    providers:
        # 使用FOSUserBundle提供的LDAP用户提供者
        fos_user_ldap:
            id: fos_userbundle.ldap.user_provider

    firewalls:
        main:
            pattern: ^/
            form_login_ldap:
                provider: fos_user_ldap
                service: Symfony\Component\Ldap\Ldap
                # LDAP用户DN模板，根据你的LDAP结构调整
                dn_string: 'uid={username},dc=example,dc=com'
                check_path: /login_check
            logout:
                path: /logout
                target: /login

fos_user.yaml示例配置： #

fos_user:
    db_driver: orm
    firewall_name: main
    user_class: App\Entity\User
    ldap:
        service: Symfony\Component\Ldap\Ldap
        base_dn: dc=example,dc=com
        # LDAP搜索账号（需要有查询用户权限）
        search_dn: cn=admin,dc=example,dc=com
        search_password: your_ldap_admin_password
        # 给LDAP用户默认分配的角色
        default_roles: [ROLE_USER]

2. 确保用户提供者优先查询本地数据库 #

FOSUserBundle的默认LDAP用户提供者应该会先检查本地数据库是否存在用户，如果存在则更新（比如更新last_login字段），如果不存在才从LDAP同步创建新用户。如果你的项目用了自定义用户提供者，需要确保实现这个逻辑：

namespace App\Security;

use FOS\UserBundle\Model\UserManagerInterface;
use FOS\UserBundle\Security\LdapUserProvider;
use Symfony\Component\Ldap\LdapInterface;
use Symfony\Component\Security\Core\User\UserInterface;

class CustomLdapUserProvider extends LdapUserProvider
{
    private $userManager;

    public function __construct(
        LdapInterface $ldap,
        UserManagerInterface $userManager,
        string $baseDn,
        ?string $searchDn = null,
        ?string $searchPassword = null,
        array $defaultRoles = []
    ) {
        parent::__construct($ldap, $baseDn, $searchDn, $searchPassword, $defaultRoles);
        $this->userManager = $userManager;
    }

    public function loadUserByIdentifier(string $identifier): UserInterface
    {
        // 先尝试通过邮箱或用户名查找本地用户
        $user = $this->userManager->findUserByEmail($identifier);
        if (!$user) {
            $user = $this->userManager->findUserByUsername($identifier);
        }

        if ($user) {
            // 更新用户的最后登录时间
            $user->setLastLogin(new \DateTime());
            $this->userManager->updateUser($user);
            return $user;
        }

        // 本地没有用户时，从LDAP获取并创建新用户
        return parent::loadUserByIdentifier($identifier);
    }
}

3. 验证用户实体的唯一约束配置 #

确认你的User实体中emailCanonical字段的唯一注解是否正确（对应数据库的UNIQ_957A6479A0D96FBF索引）：

use FOS\UserBundle\Model\User as BaseUser;
use Doctrine\ORM\Mapping as ORM;

/**
 * @ORM\Entity
 * @ORM\Table(name="fos_user")
 */
class User extends BaseUser
{
    // ... 其他字段

    /**
     * @ORM\Column(type="string", length=180, unique=true)
     */
    protected $emailCanonical;

    // ...
}

总结 #

问题的根源是登录流程没有正确检测本地已存在的用户，导致重复插入。通过检查配置、确保用户提供者的逻辑正确，就能解决这个问题。如果是自定义登录逻辑，一定要先查询本地用户，存在则更新，不存在才创建。

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