Laravel 4.2连接XAMPP MySQL异常：迁移正常但页面访问报SQLSTATE[HY000][2002]错误

这个错误我之前帮不少开发者排查过，Laravel 4.2和你平时用的Laravel 5+在MySQL连接配置上确实有一些细微差异，尤其是搭配XAMPP的时候。虽然你已经成功完成了迁移和填充，但网页访问时的连接逻辑和命令行迁移时可能走了不同的配置路径，咱们一步步来解决：

• 检查数据库配置文件的关键参数
  打开app/config/database.php，找到mysql配置数组：

  • 如果你是Mac/Linux用户：XAMPP的MySQL默认使用socket连接，而Laravel 4.2不会自动识别这个路径，需要手动添加unix_socket字段。比如：

    'mysql' => array(
        'driver'    => 'mysql',
        'host'      => 'localhost',
        'database'  => '你的数据库名',
        'username'  => 'root',
        'password'  => '', // 你的XAMPP MySQL密码，默认是空
        'charset'   => 'utf8',
        'collation' => 'utf8_unicode_ci',
        'prefix'    => '',
        'unix_socket' => '/Applications/XAMPP/xamppfiles/var/mysql/mysql.sock',
    ),
    

  • 如果你是Windows用户：把host从localhost改成127.0.0.1。因为Windows下localhost会优先尝试socket连接，但XAMPP的MySQL默认是通过TCP/IP的3306端口提供服务，用127.0.0.1可以强制走TCP连接，避免找不到socket的问题。

• 清除配置缓存
  即使你刚改完配置，Laravel可能还缓存了旧的配置信息。在项目根目录的终端里运行：

  php artisan config:clear
  

  这个命令会清除所有配置缓存，确保网页访问时加载最新的数据库配置。

• 验证环境一致性
  你能成功完成迁移填充，大概率是因为命令行使用的PHP环境和XAMPP Apache的PHP环境配置不同。命令行可能自动找到了MySQL的socket路径，而Apache的PHP环境没有，所以才会出现“迁移成功但网页报错”的矛盾情况。上面的配置修改就是为了让Apache的PHP环境也能正确找到MySQL服务。

• 确认MySQL服务状态
  最后再检查一下XAMPP控制面板里的MySQL服务是否处于Running状态，端口是否是3306（如果你的MySQL改了端口，记得在database.php里添加'port' => '你的端口号'字段）。

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