在系统管理、开发调试或自动化脚本编写中，通过命令行界面（CMD）直接连接到数据库是一项非常实用且高效的技能，它绕过了图形化界面的繁琐，提供了更直接、更底层的交互方式，当数据库服务并非运行在默认端口时，如何在连接命令中正确指定端口，就成了一个关键问题，本文将详细介绍如何使用CMD连接到运行在指定端口上的不同类型数据库，并提供必要的故障排查思路。
连接前的基本要素
无论连接哪种数据库,通常都需要准备以下几个核心信息：
- 主机地址：数据库服务器所在的IP地址或域名，如果是本地数据库，通常使用
localhost或0.0.1。 - 端口号：数据库服务监听的特定网络端口，这是本文的重点，MySQL默认为3306，PostgreSQL默认为5432，SQL Server默认为1433，如果管理员修改了这些默认值，就必须在连接时明确指定。
- 用户名：拥有数据库访问权限的账户。
- 密码：对应用户名的密码。
- 数据库名称：连接后默认进入的数据库（可选，但通常是必需的）。
常见数据库的连接命令示例
不同的数据库系统提供了各自的命令行客户端工具,以下将分别介绍MySQL、PostgreSQL和SQL Server的连接方法。
连接 MySQL 数据库
MySQL的命令行客户端是 mysql.exe，指定端口需要使用大写的 -P 参数（注意，不是小写的 -p，-p 用于指定密码）。
命令格式：
mysql -h <主机地址> -P <端口号> -u <用户名> -p
参数解释：
-h或--host: 指定数据库主机地址。-P或--port: 指定数据库端口号。-u或--user: 指定用户名。-p或--password: 提示输入密码，为了安全，建议不在命令中直接写明密码，而是在执行命令后根据提示输入。
实际示例：
假设要连接到IP地址为 168.1.100 的服务器上，端口为 3307（非默认）的MySQL数据库，用户名为 admin。
在CMD中执行：
mysql -h 192.168.1.100 -P 3307 -u admin -p
按下回车后,系统会提示 Enter password:，此时输入密码即可完成连接。
连接 PostgreSQL 数据库
PostgreSQL的命令行客户端是 psql.exe，指定端口使用小写的 -p 参数。
命令格式：
psql -h <主机地址> -p <端口号> -U <用户名> -d <数据库名称>
参数解释：
-h或--host: 指定主机地址。-p或--port: 指定端口号。-U或--username: 指定用户名。-d或--dbname: 指定要连接的数据库名称。
实际示例：
假设要连接到IP地址为 0.0.5 的服务器上，端口为 5433（非默认）的PostgreSQL数据库，用户名为 postgres，数据库名为 testdb。
在CMD中执行：
psql -h 10.0.0.5 -p 5433 -U postgres -d testdb
按下回车后,系统会提示输入 postgres 用户的密码。
连接 SQL Server 数据库
SQL Server的命令行客户端是 sqlcmd.exe，它的语法稍有不同，主机和端口通过 -S 参数一起指定，中间用逗号隔开。
命令格式：
sqlcmd -S <主机地址>,<端口号> -U <用户名> -P <密码>
参数解释：
-S: 指定服务器实例，格式为主机地址,端口号。-U: 指定用户名（使用SQL Server身份验证）。-P: 指定密码，与MySQL不同，sqlcmd可以直接在命令中提供密码，但这有安全风险。
实际示例：
假设要连接到IP地址为 16.0.20 的服务器上，端口为 1533（非默认）的SQL Server，用户名为 sa，密码为 YourPassword123。
在CMD中执行：
sqlcmd -S 172.16.0.20,1533 -U sa -P YourPassword123
连接成功后,会出现 1> 提示符，可以输入T-SQL语句。
为了更直观地对比,下表小编总结了这三种数据库的连接方式：
| 数据库类型 | 客户端工具 | 端口参数 | 命令示例（关键部分） |
|---|---|---|---|
| MySQL | mysql |
-P (大写) |
mysql -h host -P 3307 -u user -p |
| PostgreSQL | psql |
-p (小写) |
psql -h host -p 5433 -U user -d db |
| SQL Server | sqlcmd |
-S host,port |
sqlcmd -S host,1533 -U user -P pass |
连接前的测试与故障排查
如果直接使用客户端工具连接失败,可以先使用 telnet 工具测试网络连通性。
使用 telnet 测试端口：
telnet 是一个简单的网络协议工具，可以用来测试目标主机的某个端口是否开放。
命令格式：
telnet <主机地址> <端口号>
示例：
测试 168.1.100 的 3307 端口是否可达。
telnet 192.168.1.100 3307
- 如果屏幕变黑或显示连接成功信息,说明端口是开放的，网络层面是通的。
- 如果提示“连接失败”或“无法打开到主机的连接”，则可能是防火墙阻止、地址错误、服务未启动或端口配置错误。
常见错误及解决方法：
- “'mysql'/'psql'/'sqlcmd' 不是内部或外部命令...”
- 原因：数据库的
bin目录没有被添加到系统的PATH环境变量中。 - 解决：找到客户端工具的完整路径（如
C:\Program Files\MySQL\MySQL Server 8.0\bin\mysql.exe）并执行，或者将该路径添加到系统环境变量PATH中。
- 原因：数据库的
- “Access denied for user 'user'@'host'”
- 原因：用户名或密码错误，或者该用户没有从你的IP地址（
host）登录的权限。 - 解决：核对凭据，并联系数据库管理员检查用户权限。
- 原因：用户名或密码错误，或者该用户没有从你的IP地址（
- “Can't connect to MySQL server on 'host' (10061)” 或类似连接超时错误
- 原因：网络不通、防火墙阻拦、数据库服务未运行，或者端口/主机地址配置错误。
- 解决：使用
telnet测试，检查服务器防火墙规则，确认数据库服务状态和配置。
相关问答FAQs
Q1：为什么我需要指定端口？直接连接不行吗？ A1： 数据库服务运行在服务器的一个特定端口上，就像店铺需要一个具体的门牌号一样，客户端必须知道这个“门牌号”才能准确地找到并与之通信，虽然每种数据库都有一个默认端口（如MySQL的3306），但在实际生产环境中，出于安全考虑（避免被自动化工具扫描）、避免端口冲突或需要在一台服务器上运行多个数据库实例等原因，管理员经常会修改默认端口，当数据库未使用默认端口时，就必须在连接命令中明确指定。
Q2：使用 telnet 连接成功，但使用数据库客户端工具（如 mysql）却失败，这是什么原因？
A2： 这恰恰说明了问题所在。telnet 成功证明了你的电脑到数据库服务器的网络链路是通的，并且服务器的指定端口是开放的，防火墙也允许了这次连接，数据库客户端工具连接失败，问题就出在数据库层面，而非网络层面，最常见的原因包括：① 提供的用户名或密码不正确；② 该用户没有被授予从你的客户端IP地址登录的权限；③ 你尝试连接的数据库实例本身有问题，这时应重点核对认证信息和用户权限。