SQLSTATE[HY000] [2002] Permission denied: Причины и решения

Ошибка SQLSTATE[HY000] [2002] Permission denied — частая проблема, с которой сталкиваются разработчики и администраторы при работе с MySQL. Она указывает на отказ в доступе или проблемы подключения к базе данных. Понимание ее причин и методов устранения является критически важным. Эта ошибка универсальна для большинства Linux систем, включая 16 дистрибутивов Linux для 32-битных компьютеров, так как ее корни лежат в базовых принципах Unix-подобных ОС.

Понимание ошибки SQLSTATE[HY000] [2002] Permission denied

SQLSTATE HY000 — общий код ошибки, указывающий на внешние факторы. MySQL ошибка 2002 уточняет невозможность подключения к локальному серверу MySQL через Unix сокет. Сообщение Permission denied прямо указывает на отсутствие необходимых прав для доступа к ресурсу у пользователя или процесса, пытающегося установить соединение.

Распространенные причины и методы устранения

1. Проблемы с Unix сокетом (файл mysql.sock)

MySQL для локальных подключений использует Unix сокет – специальный файл, называемый файл mysql.sock.

• Неправильный путь: Клиент и сервер могут использовать разные пути к сокету, настраиваемые в конфигурация my.cnf (параметр socket) и в приложении.
• Отсутствие/повреждение: файл mysql.sock может отсутствовать, если MySQL-сервер не запущен или аварийно завершил работу.
• Решения:
  • Проверьте my.cnf (например, /etc/my.cnf) на socket в секции [mysqld].
  • Убедитесь, что MySQL запущен: systemctl status mysql.
  • Укажите верный путь сокета в конфигурации приложения.
  • Сокет обычно находится в каталоге datadir или /var/run/mysqld/.

2. Права доступа к файлу mysql.sock или каталогу сокета

Даже при наличии файла mysql.sock, у пользователя клиентского приложения (напр., www-data), могут отсутствовать права доступа MySQL для чтения/записи. Это классический случай разрешение доступа.

• Решения:
  • Проверьте владельца и права файла mysql.sock: ls -l /path/to/mysql.sock (должен принадлежать mysql:mysql).
  • Убедитесь, что родительский каталог сокета имеет права для доступа пользователю приложения.
  • Используйте chown и chmod для корректировки прав: chown mysql:mysql /path/to/mysql.sock и chmod 660 /path/to/mysql.sock.

3. Неправильные привилегии пользователя MySQL

Ошибка 2002 может быть вызвана отсутствием привилегии пользователя MySQL: неверные учетные данные или отсутствие прав для подключения с данного хоста.

• Решения:
  • Проверьте имя пользователя и пароль в приложении.
  • Убедитесь, что пользователь MySQL существует и имеет нужные права: SELECT user, host FROM mysql.user;.
  • При необходимости предоставьте права: GRANT ALL PRIVILEGES ON db.* TO 'user'@'localhost' IDENTIFIED BY 'pass';.

4. Проблемы с сетевым подключением MySQL

Если приложение использует сетевое подключение MySQL (напр., к 127.0.0.1), а не Unix сокет, причиной могут быть сетевые ограничения.

• Параметр bind-address: В конфигурация my.cnf bind-address определяет IP-адрес прослушивания. 127.0.0.1 – только локальные подключения. 0.0.0.0 – все интерфейсы.
• Брандмауэр: Брандмауэр (ufw, firewalld, iptables) может блокировать порт MySQL (3306).
• Решения:
  • Проверьте bind-address в my.cnf.
  • Откройте порт 3306 в брандмауэр: ufw allow 3306/tcp.
  • Проверьте связность: telnet your_mysql_host 3306.

5. Ограничения безопасности (SELinux/AppArmor)

В Linux (CentOS/RHEL для SELinux, Ubuntu/Debian для AppArmor) системы принудительного контроля доступа могут блокировать доступ к файлу mysql.sock или другим ресурсам.

• Решения:
  • Проверьте логи аудита SELinux (/var/log/audit/audit.log) или AppArmor (/var/log/syslog).
  • Временно отключите SELinux (setenforce 0) или AppArmor (systemctl stop apparmor) для диагностики.
  • Настройте соответствующие правила (audit2allow для SELinux, aa-genprof для AppArmor).

Инструменты для устранения неполадок MySQL

• Логи ошибок MySQL: Всегда начинайте с просмотра логи ошибок MySQL (log_error в my.cnf, обычно /var/log/mysql/error.log).
• Проверка статуса MySQL: systemctl status mysql покажет, запущен ли сервер.
• Проверка конфигурации: Используйте grep -r "socket" /etc/mysql/ для поиска параметров.

Ошибка SQLSTATE[HY000] [2002] Permission denied решается систематической проверкой конфигурации MySQL, прав доступа к файлам (файл mysql.sock, datadir), сетевых настроек (bind-address, брандмауэр) и систем безопасности (SELinux, AppArmor). Внимательное изучение логи ошибок MySQL и понимание работы MySQL socket упрощают устранение неполадок MySQL. Эти принципы применимы к большинству систем, включая 16 дистрибутивов Linux для 32-битных компьютеров.