HBase协处理器无法加载新版本？替换HDFS Jar仍加载旧版本

我在HBase 1.3.x版本里也碰到过一模一样的问题，你猜的没错，HDFS和HBase RegionServer的双重缓存确实是罪魁祸首。下面一步步给你排查和解决的方法：

1. 先确认HDFS上的Jar确实是新版本 #

首先别着急排查缓存，先确保你上传的新版本Jar真的覆盖了旧文件。可以用这些命令验证：

• 查看Jar内的目标类信息（比如类的路径，结合本地新版本类的时间戳对比）：

  hdfs dfs -cat hdfs://master/user/coprocessor-1.0.jar | jar tf - | grep IndexCoprocessor
  

• 如果发现还是旧内容，说明上传时没覆盖成功——HDFS默认不会自动覆盖已存在的文件，你需要加上-f参数重新上传：

  hdfs dfs -put -f local/new-coprocessor-1.0.jar hdfs://master/user/coprocessor-1.0.jar
  

2. 清空HBase RegionServer的本地Jar缓存 #

HBase的RegionServer会把加载的协处理器Jar下载到本地临时目录缓存起来，即使HDFS上的文件更新了，它也会优先用本地缓存。你需要：

• 找到RegionServer的缓存目录：通常是/tmp/hbase-${HBASE_USER}/lib（比如/tmp/hbase-hadoop/lib），或者查看HBase配置里hbase.local.dir参数对应的目录下的临时文件夹。
• 登录每个RegionServer节点，删除缓存的目标Jar文件：

  rm -f /tmp/hbase-hadoop/lib/coprocessor-1.0.jar
  

3. 确保协处理器的unset操作真的生效 #

有时候unset命令可能因为表状态或者属性问题没执行成功，先检查表的当前属性：

hbase shell> describe 'my:table'

如果还能看到coprocessor$1的配置，就用带FORCE参数的unset命令重新执行：

hbase shell> alter 'my:table', METHOD => 'table_att_unset', NAME => 'coprocessor$1', FORCE => true

4. 让Region重新加载协处理器 #

协处理器是在Region打开的时候加载的，所以需要触发Region重新打开：

• 最简单的方式是禁用再启用表：

  hbase shell> disable 'my:table'
  hbase shell> enable 'my:table'
  

• 如果不能禁用表（业务不允许），可以逐个flush并compact Region，或者重启单个RegionServer（但重启会影响该节点上的Region服务）。

5. 后续避免缓存问题的小技巧 #

为了以后不再踩这个坑，建议你给协处理器Jar加版本号命名，比如coprocessor-1.0.jar、coprocessor-1.1.jar，每次更新用新的版本文件名。这样HBase会识别为新文件，直接下载新版本，不会依赖旧缓存：

hbase shell> alter 'my:table', METHOD => 'table_att', 'coprocessor$1' => 'hdfs://master/user/coprocessor-1.1.jar|com.xxx.IndexCoprocessor||'

内容的提问来源于stack exchange，提问作者another JJz