本地运行laravel-json-api demo时SQL未给文本字段加引号触发MySQL报错

核心误区澄清 #

• 报错中展示的select * from \users` where `email` = frankie@example.com limit 1`并非实际发送到MySQL执行的语句，这是Laravel抛出查询异常时，为方便调试直接将绑定参数替换SQL占位符生成的展示文本，实际执行时使用PDO预处理语句，不会移除字符串两侧的引号。
• 报错主信息SQLSTATE[HY000] [2002] No such file or directory属于数据库连接阶段的错误，程序尚未走到SQL执行环节，本质是连接配置不匹配导致无法建立和MySQL的通信。

具体解决步骤 #

1. 修正冲突的连接参数 #

现有配置同时混用了tcp连接参数和MAMP专属的unix socket参数，是2002报错的核心诱因：

• 配置中同时存在tcp连接相关参数（host = 127.0.0.1、port = 8889）和硬编码的unix_socket = /Applications/MAMP/tmp/mysql/mysql.sock（仅适用于本地MAMP运行环境）
• 若项目运行在ddev启动的Docker容器内，容器环境无法访问宿主机上的MAMP socket文件路径，必然触发文件不存在的连接错误
  • 选择MAMP本地MySQL作为数据库时：删除配置中硬编码的unix_socket项，保留tcp连接参数，确认MAMP的MySQL开启tcp8889端口监听，且.env中配置的数据库账号、密码和MAMP实际配置一致
  • 选择ddev容器自带MySQL作为数据库时：删除配置中的MAMP socket路径，将.env内的DB_HOST改为ddev容器网络的数据库主机名（通常为db），DB_PORT改为容器内MySQL默认端口3306，匹配ddev初始化的数据库账号密码配置

2. 验证文件路径有效性 #

如果确实需要通过unix socket连接数据库，需确认PHP运行环境可访问对应路径：

• 本地环境下先执行ls /Applications/MAMP/tmp/mysql/mysql.sock确认socket文件真实存在，且PHP运行用户有读取权限
• 禁止在容器运行环境下硬编码宿主机的文件路径，跨系统路径在容器内必然不存在

3. 验证连接可用性 #

配置修改完成后，在项目实际运行环境（而非宿主机终端）内执行连通性校验：

• 进入项目根目录执行php artisan tinker，运行\DB::connection()->getPdo();，无报错则说明连接配置正常
• 若仍报2002错误，检查PHP环境是否正确开启pdo_mysql扩展，避免驱动缺失导致的连接失败
• 连接成功后，可将配置中的collation值调整为和MySQL实际的utf8_general_ci排序规则一致，避免后续出现字符集兼容问题

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