首批通过分布式安全可靠测评，为关键业务系统打造
划线反馈
Bootstrap 失败，错误代码 4016
更新时间：2026-05-07 06:36
分享
适用版本：V2.1.x、V2.2.x、V3.1.x、V3.2.x内容类型：Troubleshoot
本文介绍手动部署 OceanBase 集群过程中执行 bootstrap 报 4016 错误时，如何进行问题排查并解决问题。
影响版本
适用于 OceanBase 数据库所有版本。
问题现象
手动部署 OceanBase 集群过程中，执行 bootstrap 提示错误，信息如下所示：
[admin@hostname ~]$ cd /home/admin/oceanbase
[admin@hostname oceanbase]$ ./bin/observer -o "rootservice_list=xxx.xxx.x.xxx:2882:2881;xxx.xxx.x.xxx:2882:2881;xxx.xxx.x.xxx:2882:2881,memory_limit_percentage=90"
[2020-02-15 03:22:11.883529] ERROR [SQL.EXE] start_trans (ob_sql_trans_control.cpp:273) [60623][868][YB426451898A-00059E8D617A10CE] [lt=0] [dc=0] org_cluster_id is set to cluster_id, but it is out of range(ret=-4016, org_cluster_id=0, OB_MIN_CLUSTER_ID=1, OB_MAX_CLUSTER_ID=4294901759) BACKTRACE:0x6d7e65a 0x6d2c905 0x4303d3 0x92e664 0x42a1611 0x42a16aa 0x42a1bf0 0x66dacee 0x5a80abc 0x425bd6f 0x425d08f 0x4c32f75 0x4c2b80a 0x4c2c1c1 0x4c2d052 0x6d01546 0x6d015e7 0x48edc02 0x48edf5c 0x48eeb11 0x48ed191 0x48f3aca 0x3df78d5 0x6cb7637 0x6cb5b2a 0x6ef56cf
[2020-02-15 03:22:12.873050] ERROR [BOOTSTRAP] bootstrap (ob_service.cpp:2249) [60760][1114][YB426451898A-00059E8D617A10BA] [lt=11] [dc=0] execute bootstrap fail(master_rs="xxx.xx.xxx.xxx:2882", timeout=300000000, ret=-4016) BACKTRACE:0x6d7e65a 0x6d2c905 0xd9855b 0x16c6ef6 0x4c688f4 0x647238b 0x6dfe98a 0x4fd146a 0x4fcd683 0x3df78c0 0x6cb7637 0x6cb5b2a 0x6ef56cf
可能原因
查看错误日志的关键信息：
ret=-4016, org_cluster_id=0, OB_MIN_CLUSTER_ID=1, OB_MAX_CLUSTER_ID=4294901759
根据错误信息，判断该错误是由于 cluster_id 的设置超出取值范围。
说明
首次执行 bootstrap 时如果未指定 cluster_id，系统就会使用默认值 0，而 cluster_id 的取值范围为 1～4294901759，导致 cluster_id 的值因超出取值范围而报错。
解决方法
通过 -c 参数指定 cluster_id 启动，例如：
[admin@hostname ~]$ cd /home/admin/oceanbase
[admin@hostname oceanbase]$ ./bin/observer -c 1 -o "rootservice_list=xxx.xxx.x.xxx:2882:2881;xxx.xxx.x.xxx:2882:2881;xxx.xxx.x.xxx:2882:2881,memory_limit_percentage=90"
