用途:面向 OBProxy/ODP 的路由策略、弱读、只读副本、读写分离、租户/集群名解析、proxyro、rs_list、OB 2.0 协议、代理侧内存与内部元数据查询超时等配置类问题排障。日志采集与解读应改用 obproxy-log-analysis,单条 SQL 执行计划与锁问题应改用 observer-sql-analysis。
前置信息:尽量明确 OBProxy/ODP 版本、OceanBase 版本、连接串、是否多 ODP/VIP、是否经 2883、是否在事务中。需要配置时登录 root@proxysys,使用 SHOW proxyconfig / ALTER proxyconfig;多集群传 cluster_config_path;涉及 Observer 侧事实时用 db_query 查 sys/租户视图。
主要分支:分区键需在 SQL 前 4KB 内,避免大字段排在分区键前导致 decode varchar param value failed;弱读 hint 只声明一致性,是否优先 follower 还取决于 proxy_route_policy,可用 SET SESSION ob_read_consistency = 'weak'、SELECT /+READ_CONSISTENCY(WEAK)/ 与 ALTER proxyconfig SET proxy_route_policy = 'follower_first',注意全局/ODP 级影响并记录旧值与回滚;cluster not exist 需排查命名过长、https config server、rslist、固定租户;proxyro 认证失败需核对 proxy_config 密码与 sys 租户 proxyro 一致,必要时 ALTER PROXYCONFIG SET skip_proxyro_check='true';OBD 部署连不上时核对 rs_list;单台 ODP 2013 查 obproxy_error.log 与 connection freeze,可调 proxy_mem_limited;仅用户名连接可设 enable_full_username='false' 与 proxy_tenant_name;GET_LOCK 报 1235 可检查 enable_ob_protocol_v2、enable_single_leader_node_routing、client_session_id_version;SHOW CREATE TABLE 兼容模式检查 _show_ddl_in_compat_mode 与 init_sql;新建表经代理慢可调 short_async_task_timeout 并收集统计信息;多 ODP 下 SHOW/KILL 需落在同一台 ODP。
限制:具体版本差异、参数默认值与适用条件以实际环境为准;变更前确认影响范围与回滚方案;资料未提供完整版本兼容矩阵与全部参数取值。