document.writeln('');
mysqli_connect()失敗返回false但無報(bào)錯(cuò),需立即檢查返回值并調(diào)用mysqli_connect_error()獲取真實(shí)原因;常見原因包括未開啟錯(cuò)誤提示、錯(cuò)誤被@抑制、MySQLi擴(kuò)展未啟用、連接被拒絕或權(quán)限不足。

mysqli_connect_error()PHP 連數(shù)據(jù)庫失敗卻看不到具體錯(cuò)誤,大概率是沒開啟錯(cuò)誤提示或沒捕獲返回值。mysqli_connect() 失敗時(shí)返回 false,但不會(huì)自動(dòng)拋異常,必須手動(dòng)調(diào)用 mysqli_connect_error() 才能拿到真實(shí)原因。
常見遺漏點(diǎn):
false 調(diào)用 mysqli_query(),導(dǎo)致后續(xù)報(bào)“expects mysqli object”類錯(cuò)誤@ 抑制,或 display_errors = Off + log_errors = Off 導(dǎo)致完全靜默php -m | grep mysqli 確認(rèn))建議寫法:
1 2 3 4 |
|
Connection refused 表示 PHP 嘗試 TCP 握手失敗,不是賬號(hào)密碼錯(cuò),而是根本連不到 MySQL 進(jìn)程。
立即學(xué)習(xí)“PHP免費(fèi)學(xué)習(xí)筆記(深入)”;
按順序排查:
systemctl status mysql(Linux)或任務(wù)管理器里看 mysqld.exe(Windows)127.0.0.1:3306,但配置文件中 bind-address 設(shè)為 127.0.0.1 時(shí)無法從容器或遠(yuǎn)程連接;Docker 場景常用 host.docker.internal 或宿主機(jī) IPfirewall-cmd --list-ports 看 3306 是否放行;云服務(wù)器還要查安全組規(guī)則telnet 127.0.0.1 3306 或 nc -zv 127.0.0.1 3306 驗(yàn)證端口可達(dá)性Access denied for user xxx@yyy 是最典型的權(quán)限類錯(cuò)誤,但 yyy 不一定是你想象的來源地址。
關(guān)鍵點(diǎn):
user@host 組合,root@localhost 和 root@% 是兩個(gè)不同用戶,后者才允許遠(yuǎn)程連接$host 值決定匹配哪個(gè) @host:填 127.0.0.1 匹配 @127.0.0.1,填 localhost 在 Unix 套接字下可能走 socket 而非 TCP,行為不一致caching_sha2_password 插件,老版本 PHP(ALTER USER xxx@% IDENTIFIED WITH mysql_native_password BY pwd;CLI 和 Web(如 Apache mod_php / FPM)可能加載不同的 php.ini,導(dǎo)致一個(gè)環(huán)境能連、另一個(gè)不能。
驗(yàn)證步驟:
<?php phpinfo(); ?> 頁面,搜 pdo_mysql,確認(rèn)已啟用且版本匹配php -m | grep pdo 和 php --ini,對(duì)比配置路徑是否與 Web 環(huán)境一致php:alpine)需手動(dòng)安裝擴(kuò)展:docker-php-ext-install pdo_mysql,僅 apk add php-pdo 不夠php.ini 必須重啟 php-fpm 進(jìn)程,reload 不一定生效連接字符串中主機(jī)名、端口、字符集(?charset=utf8mb4)漏寫或?qū)戝e(cuò),也會(huì)靜默失敗或報(bào)語法錯(cuò)誤,這類細(xì)節(jié)最容易在遷移環(huán)境時(shí)被忽略。