MariaDB 教程 / 在 Windows 上安装并验证服务与数据库连接
在 Windows 上,可以使用 MSI 安装包安装 MariaDB Server,并将数据库实例作为 Windows 服务运行。安装时记录服务名称、端口和管理员密码,随后通过客户端连接和 SQL 查询确认服务器工作正常。完成这些检查后,再创建权限限定在练习数据库内的账号。
安装前检查已有服务和端口
本文面向 64 位 Windows 11 上新建的本机学习环境。运行 MSI 或更改服务状态可能需要管理员权限。如果电脑已经安装 MariaDB 或 MySQL,应先分清“升级现有实例”和“创建独立练习实例”。MariaDB 的服务器与客户端区别有助于理解安装组件各自的作用,不能把只安装客户端视为已经准备好数据库服务器。
先在 PowerShell 中只读查询现有服务和监听端口。服务显示名称与实际的 Name 可以不同;不认识某个服务名称,也不意味着它的数据可以删除。
Get-Service | Where-Object { $_.Name -match 'MariaDB|MySQL' }
Get-NetTCPConnection -State Listen -LocalPort 3306 -ErrorAction SilentlyContinue
没有安装过服务器时,查询结果为空可能是正常情况。如果发现已有服务或 3306 已被占用,先弄清用途,不要直接停止服务或复用其数据目录。独立实例需要不同的服务名称;端口被占用时,也应选择其他空闲端口。后续所有连接命令都必须使用实际选定的端口,而不是继续机械地复制 3306。
下载 MSI 并选择安装组件
- 从MariaDB 官方下载页选择仍受支持的稳定版 MariaDB Server,以及 Windows x64 的 MSI 安装包。预览版不作为本入门环境的基准。
- 运行安装包,阅读许可条款后进入 Custom Setup。确认选择服务器、客户端以及数据库实例(Database instance)相关组件。
- 记录程序安装位置和数据目录。本文示例路径为
C:\Program Files\MariaDB 12.3\,与自己安装的位置不同时必须替换。HeidiSQL 等图形工具并不是这些命令行练习的必需组件。
不同版本的安装选项名称和界面布局可能变化,可参照官方 Windows MSI 安装说明核对实例选项。选择数据库实例组件才会在安装过程中设置相应实例。向导出现升级已有实例的选项时,不要仅因为它可选就将其用于新练习环境。
设置管理员、服务和本机连接
| 设置 | 本机学习实例的选择 |
|---|---|
| root 密码 | 为数据库管理员设置强密码,并妥善保管 |
| root 远程访问 | 本练习保持禁用 |
| 匿名账号 | 保持禁用 |
| Windows 服务 | 安装为服务,记录实际服务名称 |
| TCP 端口 | 3306 空闲时可使用;否则选择并记录其他端口 |
| 字符集选项 | 安装器的 UTF-8 选项不能替代数据库中明确的 utf8mb4 设置 |
数据库管理员密码与 Windows 登录密码不是同一个概念。检查服务器后,我们会创建独立的 SQL 练习账号。通过 127.0.0.1 连接本机不需要向外部网络开放数据库端口。完成安装后,应阅读安装结果和错误信息,不要仅凭向导关闭就判断服务已经启动。
启动服务并验证管理员连接
如果服务名称为 MariaDB,在 PowerShell 中执行下列命令。如果使用了其他名称,先替换。启动服务可能需要以管理员身份打开 PowerShell;这里只操作自己确认过的练习实例。
Get-Service -Name MariaDB
Start-Service -Name MariaDB
Get-Service -Name MariaDB
最后一次查询应显示 Running。安装附带的 MariaDB Command Prompt 可能已经配置好客户端路径。在普通 PowerShell 中使用可执行文件的完整路径,可以避免依赖 PATH 环境变量:
& "C:\Program Files\MariaDB 12.3\bin\mariadb.exe" --protocol=tcp --host=127.0.0.1 --port=3306 --user=root --password --default-character-set=utf8mb4
PowerShell 中的 & 用来调用带引号的程序路径。替换为实际安装路径和端口。单独使用 --password 而不给出值,会要求交互输入密码,避免把密码直接写进命令。连接成功后,在 MariaDB 客户端中执行:
SELECT VERSION() AS server_version;
SELECT 1 + 1 AS result;
应分别得到服务器版本和计算结果 2。版本字符串取决于实际连接的服务器,不应要求与本文示例目录完全相同。仅仅成功打开客户端程序,还不足以证明服务器可以连接或执行 SQL。
创建仅用于练习数据库的账号
root 用于初始设置,日常练习改用 course_user。先以管理员账号检查同名用户是否已经存在:
SELECT User, Host FROM mysql.user WHERE User = 'course_user';
如果有结果,检查其 Host 和用途,不要直接删除或重建已有账号。如果确认是在新环境中创建教程账号,将下列密码占位符替换为自己选择的强密码,再以管理员身份执行:
CREATE USER 'course_user'@'127.0.0.1'
IDENTIFIED BY 'CHANGE_THIS_TO_YOUR_OWN_PASSWORD';
GRANT ALL PRIVILEGES ON shopcourse.*
TO 'course_user'@'127.0.0.1';
SHOW GRANTS FOR 'course_user'@'127.0.0.1';
MariaDB 账号由用户名与主机部分共同标识。本例明确通过 TCP 连接 127.0.0.1,并授权给这个主机对应的账号。权限范围是 shopcourse.*,允许在练习数据库内完成建库、建表和数据操作,但不包含全局权限,也不包含向他人授权的权限。数据库尚未创建时,可以先授予此范围的权限;GRANT 本身不会因此创建数据库。
正式应用应按实际工作进一步缩小权限,不能将教学账号的 ALL PRIVILEGES 原样当成所有应用的最低权限。账号语法和授权范围可分别查看 CREATE USER 参考与 GRANT 参考。
在交互式客户端输入 EXIT; 断开当前连接,再回到操作系统终端连接练习账号。如果终端找不到 mariadb,使用前面展示的完整可执行文件路径,并保留下面的连接参数:
mariadb --protocol=tcp --host=127.0.0.1 --port=3306 --user=course_user --password --default-character-set=utf8mb4 --abort-source-on-error
输入刚设置的练习账号密码。连接成功后,执行:
SELECT CURRENT_USER() AS privilege_account;
privilege_account 应为 course_user@127.0.0.1。这个检查确认实际匹配的权限账号,而不仅是自己在命令中填写的用户名。通过 CREATE USER 和 GRANT 完成的这套操作立即生效,不需要手动执行 FLUSH PRIVILEGES。若以练习账号尝试读取 mysql.user 被拒绝,这是权限隔离的结果,不代表账号创建失败。
区分服务、路径和认证错误
- 服务无法启动:核对实际服务名称、端口占用和该实例的错误日志,保留数据目录。
- 找不到客户端命令:使用实际完整路径,或安装附带的 MariaDB Command Prompt。不要把命令搜索路径错误误当成数据库密码错误。
- 无法连接:检查目标服务是否正在运行,命令中的主机与端口是否指向该实例。
- Access denied:核对账号密码以及账号的主机部分。认证失败与服务器停止是两类不同问题。
更改练习实例的 my.ini 之前,先备份原文件并记录路径。每次只改一项,重启对应实例后验证结果;若修改导致无法启动,恢复所保存的配置再检查。停止服务、卸载程序和删除数据库文件是三个不同动作,删除数据不应成为修复登录错误的常规方法。




