mysql的Unix Socket连接方式是通过本地进程间通信实现数据库访问的，相比TCP/IP连接少了网络协议开销，在本地访问场景下性能更优，很多运维和开发人员会选择这种方式来配置本地数据库连接。
Unix Socket连接的基本原理
mysql服务端启动时会默认创建一个Unix域套接字文件，客户端可以通过这个文件的路径直接发起本地连接，不需要指定IP和端口。默认情况下，mysql的套接字文件通常存放在/tmp/mysql.sock或者/var/run/mysqld/mysqld.sock路径下，具体路径由服务端的配置决定。
服务端配置Unix Socket
修改mysql服务端配置文件
首先需要编辑mysql的配置文件，通常是/etc/my.cnf或者/etc/mysql/my.cnf，在[mysqld]配置段中添加或修改套接字相关参数：
[mysqld] # 指定Unix Socket文件的存放路径和名称 socket=/var/run/mysqld/mysqld.sock # 可选：指定套接字文件的权限，默认是0755 socket_permission=0755
修改完成后需要重启mysql服务让配置生效，不同系统的重启命令略有区别：
- CentOS/RHEL系统：
systemctl restart mysqld - Ubuntu/Debian系统：
systemctl restart mysql
验证服务端套接字状态
重启完成后，可以通过以下命令查看套接字文件是否生成：
# 查看套接字文件是否存在 ls -l /var/run/mysqld/mysqld.sock # 查看mysql进程监听的套接字信息 netstat -a | grep mysql
如果看到对应的套接字文件路径，说明服务端配置已经生效。
客户端通过Unix Socket连接mysql
命令行客户端连接
使用mysql自带的命令行客户端连接时，可以通过-S参数指定套接字文件路径：
# 指定套接字文件路径连接mysql mysql -u root -p -S /var/run/mysqld/mysqld.sock
如果已经将套接字路径配置到客户端的默认配置中，也可以省略-S参数直接连接：
# 客户端配置默认套接字路径后直接连接 mysql -u root -p
应用程序中配置套接字连接
不同的编程语言连接mysql时，配置Unix Socket的方式不同，以下是常见语言的示例：
PHP连接示例
<?php
// 通过Unix Socket连接mysql
$mysqli = new mysqli('localhost', 'root', 'password', 'test', null, '/var/run/mysqld/mysqld.sock');
if ($mysqli->connect_error) {
die('连接失败：' . $mysqli->connect_error);
}
echo '连接成功';
$mysqli->close();
?>
Python连接示例
import mysql.connector
# 通过Unix Socket连接mysql
config = {
'user': 'root',
'password': 'password',
'database': 'test',
'unix_socket': '/var/run/mysqld/mysqld.sock'
}
try:
conn = mysql.connector.connect(**config)
print('连接成功')
conn.close()
except Exception as e:
print(f'连接失败：{e}')
常见问题排查
| 问题现象 | 可能原因 | 解决方法 |
|---|---|---|
| 连接时提示找不到套接字文件 | 服务端未生成套接字文件，或者客户端指定的路径错误 | 检查服务端配置的套接字路径，确认文件存在，客户端指定正确路径 |
| 连接时提示权限不足 | 当前用户没有访问套接字文件的权限 | 修改套接字文件的权限，或者将当前用户加入mysql用户组 |
| 重启mysql后套接字路径恢复默认 | 配置文件修改错误，或者加载了其他配置文件覆盖了设置 | 检查配置文件的加载顺序，确认修改的配置段正确 |
配置Unix Socket连接时需要注意，这种方式仅支持本地连接，无法用于远程访问数据库，如果需要远程访问，还是需要配置TCP/IP连接方式。另外如果修改了套接字路径，所有本地客户端都需要同步更新连接配置，否则会出现连接失败的问题。
mysqlUnix_Socket套接字连接数据库配置修改时间：2026-06-17 23:18:27