MacOS下XAMPP中phpMyAdmin报错#1062：主键重复项为空

这个报错是因为phpMyAdmin自身的配置数据表存在重复的空主键记录，直接按以下步骤排查修复：

• 通过终端登录MySQL
  打开Mac终端，先切换到XAMPP的MySQL执行目录：

  cd /Applications/XAMPP/xamppfiles/bin
  

  然后登录MySQL（如果root没设密码，输入命令后直接回车跳过密码输入）：

  ./mysql -u root -p
  

• 定位phpMyAdmin的问题表
  切换到phpMyAdmin默认使用的数据库：

  USE phpmyadmin;
  

  列出所有表，找到名为pma__userconfig的表（这是存储用户配置的核心表）：

  SHOW TABLES;
  

• 检查并修复重复记录
  先查看表中数据，确认是否存在空主键的重复条目：

  SELECT * FROM pma__userconfig;
  

  你会看到username字段（这个表的主键）有多个空字符串('')的记录，直接删除这些重复的空条目：

  DELETE FROM pma__userconfig WHERE username = '';
  

  保留1条空用户的配置记录也可以，或者全部删除不影响使用。

• 验证修复结果
  退出MySQL命令行（输入exit;），然后刷新phpMyAdmin页面，应该就能正常访问了。

如果以上操作后问题依旧，可以尝试重建phpMyAdmin的配置表：找到XAMPP目录下phpmyadmin/sql/create_tables.sql文件，在MySQL命令行中执行这个脚本重新创建所有phpMyAdmin的系统表。

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