my.ini必须放在MySQL安装目录根路径(与bin同级),不能放bin下;路径需用双反斜杠或正斜杠,文件名必须为my.ini,且需显式配置[mysqld]段的basedir和datadir绝对路径。

my.ini必须放在MySQL安装目录根路径,不能放bin下
mysqld初始化时只在安装目录根路径(即和bin文件夹同级)查找my.ini,不会进bin子目录搜,也不会读注册表或环境变量。放错位置等于没配——比如解压到D:mysql-5.7.35-winx64,那my.ini就得直接放在这个目录下,而不是D:mysql-5.7.35-winx64inmy.ini。
常见错误现象:mysqld --initialize-insecure执行后data目录为空、basedir被忽略、字符集不生效、甚至启动服务时报“服务没有报告任何错误”。
- 用VS Code或Notepad++新建文件,**别用记事本**——它可能加BOM头,导致mysqld静默跳过整个配置
- 文件名必须是
my.ini,不是my-default.ini、my.cnf或my.txt - 路径中所有反斜杠必须写成双反斜杠
\或正斜杠/,单反斜杠会被Windows当转义符处理(例如D:mysqldata→D:ysqldata)
[mysqld]段里basedir和datadir必须显式指定
MySQL 5.7不会从当前工作目录或PATH推导basedir,它只认配置文件里写的绝对路径。如果漏掉这俩,初始化会退回到内置默认值(通常是C:Program FilesMySQLMySQL Server 5.7),导致datadir创建失败或权限出错。
示例正确写法:
[mysqld] port = 3306 basedir = "D:/mysql-5.7.35-winx64" datadir = "D:/mysql-5.7.35-winx64/data"
-
basedir指向MySQL解压后的**整个根目录**,不是bin目录 -
datadir路径必须已存在,或确保后续用--initialize-insecure能自动创建(推荐先手动建好空data文件夹) - 路径带空格或中文时,**必须用英文双引号包裹**,否则mysqld解析失败
- 不要写
skip-grant-tables在正式初始化前——它会让认证失效,但也会掩盖配置未加载的真实问题
客户端连接乱码?补全[client]和[mysql]段
只配[mysqld]段,mysql -u root命令仍可能报错或显示乱码,因为客户端工具(如mysql.exe)默认不读[mysqld]里的character-set-server。
必须单独配[client]和[mysql]段,且用default-character-set而非character-set-server:
[client] default-character-set = utf8mb4 [mysql] default-character-set = utf8mb4
-
utf8mb4比utf8更安全,支持emoji和四字节Unicode字符 - 如果只写
utf8,某些版本会回退到latin1,插入中文时可能截断或报错 - 这个配置不影响服务端存储逻辑,但决定客户端如何编码发送SQL和解析返回结果
静默初始化必须用--initialize-insecure,且要配--defaults-file注册服务
想脚本化部署、跳过临时密码,唯一可靠方式是mysqld --initialize-insecure。用--initialize会生成随机密码并输出到日志,但输出位置和格式不稳定(有时在hostname.err,有时只闪现在--console),无法被脚本稳定捕获。
注册Windows服务时,**必须显式传--defaults-file参数**,否则mysqld install会忽略my.ini:
mysqld install MySQL --defaults-file="D:/mysql-5.7.35-winx64/my.ini"
- 路径要用正斜杠或双反斜杠,且必须是绝对路径
- 注册后务必检查注册表项
HKEY_LOCAL_MACHINESYSTEMCurrentControlSetServicesMySQLImagePath,确认值里包含--defaults-file=...,否则服务启动时照样不读配置 -
--initialize-insecure只适用于首次部署;初始化成功后应立刻执行ALTER USER 'root'@'localhost' IDENTIFIED BY 'xxx';设密
datadir是否按你写的路径创建、show variables like 'character_set%';返回值是否符合预期。很多“配置失败”其实只是mysqld压根没看到my.ini。


















