listen_port

参数名称

listen_port

参数解释

数据库默认TCP侦听端口。

用于数据库对外服务，单节点模式或集群配置有Q角色节点才会进行侦听。

默认值

5138

访问权限

R/W

是否全局参数

是

修改生效方式

重启生效

取值范围

[1024,65535]

注意事项

端口冲突将导致侦听失败，数据库进程退出。数据库侦听建立是在启动过程最后，虽然此时出现端口冲突导致启动失败进程退出，但启动流程中其他操作已完成（加载系统表，加载job，初始化内存，redo undo，集群握手等）。

如非必要不建议修改，在测试环境如果需要单个物理机上启动多个虚谷数据库，此参数可按实际情况修改。

注意：

• 修改端口注意不要和其他程序端口冲突（如其他数据库端口、中间件端口等）。
• 侦听端口小于1024可启动成功，但不建议使用小于1024的端口，0-1023端口默认固定分配给某个服务。
• 侦听端口大于65535可启动成功且日志无报错信息，但通过该端口不可建立连接，可通过netstat -nptul|grep 进程号 查询当前的端口号进行连接数据库。
• 端口冲突启动报“create_server_port faild”错误。

侦听端口配置异常及风险：

• 集群模式单个节点加入时，节点加入成功后又退出。
• 集群模式整个集群启动时，集群启动成功立刻出现节点死亡（可能是MASTER节点和其他任意类型节点，甚至整集群）。
• 操作系统防火墙必须开放监听端口，否则用户或程序无法访问数据库。