HBase 1.1.2自定义Endpoint协处理器重部署后未更新问题

我之前维护HBase 1.1.2集群时也碰到过一模一样的问题，协处理器代码改完重新部署后死活不生效，折腾了好一阵才摸清楚几个关键坑点，咱们一步步来排查解决：

一、先确认Jar包的HDFS路径与权限 #

• 上传新Jar时，一定要覆盖旧Jar文件，或者先删除旧Jar再传新的，避免HDFS里残留同名旧文件。执行上传命令时加-f参数强制覆盖：

  hdfs dfs -put -f target/your-coprocessor.jar /user/hbase/coprocessors/
  

• 检查HBase进程对Jar包的读权限，执行：

  hdfs dfs -ls /user/hbase/coprocessors/your-coprocessor.jar
  

  确保权限是-rw-r--r--（644），如果不是，用hdfs dfs -chmod 644 /path/to/your/jar调整，否则RegionServer可能加载失败。

二、彻底移除旧协处理器 #

• 别只凭经验用coprocessor$1，先执行describe 'your_table'查看所有已挂载的协处理器，确认它们的名称（比如coprocessor$1、coprocessor$2），然后逐个移除：

  alter 'your_table', METHOD => 'table_att_unset', NAME => 'coprocessor$1'
  alter 'your_table', METHOD => 'table_att_unset', NAME => 'coprocessor$2'
  

• 移除后执行flush 'your_table'和major_compact 'your_table'，强制刷新表元数据，避免旧的协处理器信息残存在缓存里。

三、检查添加新协处理器的命令格式 #

禁用表后添加协处理器的命令要注意细节，尤其是VALUE部分的格式：

disable 'your_table'
alter 'your_table', METHOD => 'table_att', NAME => 'coprocessor$1', VALUE => 'hdfs:///user/hbase/coprocessors/your-coprocessor.jar|com.your.company.YourEndpointImpl|'
enable 'your_table'

• 这里的竖线|是分隔符，前面是完整的HDFS Jar路径，后面是协处理器的全限定类名，一定要和新Jar里的类完全一致（包括包名），不能有拼写错误。
• 如果协处理器需要传递参数，格式是路径|类名|参数，没有参数就保留前后的竖线。

四、处理RegionServer的缓存问题 #

HBase 1.1.2的RegionServer会缓存已加载的协处理器Jar，即使HDFS里的Jar更新了，RegionServer也不会自动重新加载，这是最容易踩的坑：

• 最简单有效的方法是重启所有RegionServer，让它们重新从HDFS读取新的Jar包。
• 重启后可以查看RegionServer的日志（$HBASE_HOME/logs/hbase-regionserver-*.log），搜索你的协处理器类名，确认有没有成功加载的日志信息。

五、验证更新是否成功 #

• 执行describe 'your_table'，查看输出中的协处理器列表，确认路径和类名都是新的。
• 也可以通过HBase UI的表详情页，检查协处理器信息是否正确。
• 最后写个简单的客户端代码调用你的Endpoint，测试新的业务逻辑是否生效，这是最直接的验证方式。

完整的重新部署流程总结 #

1. 编译构建最新的协处理器Jar包，确保代码修改已生效。
2. 上传新Jar到HDFS并覆盖旧文件：

   hdfs dfs -put -f target/your-coprocessor.jar /user/hbase/coprocessors/
   

3. 查看并移除所有旧协处理器：

   describe 'your_table'
   alter 'your_table', METHOD => 'table_att_unset', NAME => 'coprocessor$N' # 替换N为实际序号
   flush 'your_table'
   major_compact 'your_table'
   

4. 禁用表、添加新协处理器、启用表：

   disable 'your_table'
   alter 'your_table', METHOD => 'table_att', NAME => 'coprocessor$1', VALUE => 'hdfs:///user/hbase/coprocessors/your-coprocessor.jar|com.your.company.YourEndpointImpl|'
   enable 'your_table'
   

5. 重启所有RegionServer。
6. 验证协处理器是否正常工作。

内容的提问来源于stack exchange，提问作者Data Man