数据库连接端口号具体是多少呢？

这篇文章共计1349个文字，预计阅读时间6分钟。

端口号是计算机网络中用于标识不同应用程序或服务的一种机制。它是一个 16 位无符号整数，范围从 0 到 65535。在 TCP/IP 协议栈里每个端口号对应一个特定的服务或应用程序。按理说，对数据库而言，端口号就是客户端与数据库服务器进行通信时必须指定的“入口”。如果端口弄错，连接必然失败，这也是很多同学在实际项目中最常碰到的痛点。

二、常见数据库默认端口号一览

1. MySQL：默认端口号为 3306
2. PostgreSQL：默认端口号为 5432
3. Oracle Database：默认端口号为 1521
4. Microsoft SQL Server：默认端口号为 1433
5. MongoDB：默认端口号为 27017

*提示：以上均为“开箱即用”的默认值，实际部署时往往会因安全或冲突需求自行修改。

三、实际工作中碰到的痛点 & 对策

• 找不到正确端口：新接手项目或第三方 SaaS 环境时文档不全导致只能盲目尝试。
• 同一台机器上跑多个实例：A 机器上既有 MySQL 又有 PostgreSQL。若未手动指定，就会出现“端口已被占用”的报错。
• 防火墙拦截：SLA 要求只开放业务必需的端口，却忘记在防火墙或云安全组里放行对应端口。
• 改动后服务不可用：修改配置后忘记重新启动或重启顺序错误，会导致业务瞬间宕机。
• Docker/K8s 环境混淆：K8s Service 与容器内部端口映射不一致，使得外部访问仍然走旧端口。按理说，

四、如何更改数据库端口号

4.1 Windows 程序下的操作步骤

1. Edit configuration file: 打开对应数据库的配置文件。找到 段落中的#port=3306。
2. Edit service parameters ： 对于 SQL Server，可通过"SQL Server Configuration Manager"->"SQL Server Network Configuration"->"Protocols for MSSQLSERVER"->"TCP/IP"。在"IP All"页修改Tcp Port.
3. Create firewall rule: 在「Windows Defender 防火墙」中新建入站规则，放行新设定的端口。
4.  打开「服务」管理器。重新启动对应数据库服务，使配置生效。
5.  使用客户端工具或命令行`mysql -h localhost -P 33306 -u root -p`,确认可以正常连接。怎么说呢，

4.2 Linux 程序下的操作步骤

1. Edit config file: 以 MySQL 为例。编辑/etc/my.cnf**或**/etc/mysql/mysql.conf.d/mysqld.cnf**文件**，找到`port = 3306`,改为想要的新值，如`port = 33306`。
2. Edit PostgreSQL config: 编辑/var/lib/pgsql/data/postgresql.conf,将#port = 5432 改为新的数字； 在/var/lib/pgsql/data/pg_hba.conf 检查对应 IP 段是否允许该新端口。说起来，
3. Edit firewall :
   • If using iptables: 

     `iptables -A INPUT -p tcp --dport 33306 -j ACCEPT` && `service iptables save` 

   If using firewalld: 

   `firewall-cmd --add-port=33306/tcp --permanent && firewall-cmd --reload` 

4. Restart service : 在终端执行相应程序ctl 命令。例如： `systemctl restart mysqld` 或 `systemctl restart postgresql`。
5. **Verify connection** : 使用客户端工具或者 curl/nc 检测新端口是否打开。至于示例，`nc -zv localhost 33306`。

4.3 容器化环境注意事项

• **Docker run** : 指定容器内部与宿主机映射，如 `docker run -p 33306:3306 mysql:5.7`。老实说，
• **K8s Service** : Service 的 targetPort 为容器内部原始 порт。而 port 为暴露给集群外部的 порт . 必须保持两者一致，否则会出现 “connection refused”。
• **ConfigMap / Secret** : 将自定义 порт 写入 ConfigMap。并在 Pod 启动参数里引用，以免硬编码。

• Error: "Can't connect to MySQL server on '127.0.0.1' " : 通常代表着客户端尝试访问默认3306，但服务器已经改成了别的 порт . 检查 client connection string 中是否明确写了新 порт。老实说，
• Error: "ORA-12541: TNS:no listener" : Oracle Listener 没有监听指定 порт . 用 `lsnrctl status` 查看当前监听情况。并确保 tnsnames.ora 中匹配。
• Error: "timeout expired" on SQL Server : 防火墙未放行新порт 或云安全组限制。先 ping 检查网络通畅，再使用 telnet 检测 `:new_port` 是否可达。
• Port conflict : 使用 `netstat -tlnp | grep PORT` 查找占用进程；话说回来，如果是旧实例未关闭，需要先 stop 再 start。

• 了解并记住每种主流 DB 的默认 порт ： MySQL 3306、PostgreSQL 5432、Oracle 1521、SQL Server 1433、MongoDB 27017。当文档缺失时这些数字是快速定位问题的第一步先。
• 若业务要求更改 порт，务必同步以下三件事：配置文件 → 防火墙/安全组 → 客户端连接字符串。缺一不可，否则会出现“连不上”“被防火墙拦截”等尴尬场景。
• 修改后记得重启相应服务。并使用 `nc`,`telnet`,`ping` 等轻量工具做连通性验证。
• 在容器化环境里“宿主机‑容器映射” 与 “K8s Service‑PodPort” 常常被忽视，请务必检查两层映射是否一致。

祝你快速定位正确港​⟩并顺利完成数据库连接！​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​.