RabbitMQ 4.0执行rabbitmqctl报function undef错误的原因与复现方法

问题原因 #

这个{:undef, [...]}错误本质是Erlang虚拟机无法找到rabbit_amqp1_0:list_local/0的有效实现，结合修改函数名即可正常运行的现象，核心原因集中在以下几点：

• 模块代码版本不匹配：RabbitMQ节点加载了旧版本的rabbit_amqp1_0模块，该版本未包含list_local/0函数；或者本地源码编译后，节点未重新加载最新模块，仍使用缓存中的旧代码。
• 函数导出遗漏：虽然你确认函数定义正常，但可能编译时rabbit_amqp1_0模块的-export([...])列表中未添加list_local/0，导致函数未对外暴露；修改函数名后重新编译，触发了导出列表的同步更新。
• 插件加载异常：AMQP 1.0插件（rabbitmq_amqp1_0）未正确启用或加载，导致rabbit_amqp1_0模块未被节点加载，此时调用该模块函数会触发未定义错误。

复现方式 #

场景1：编译缓存残留导致版本不一致 #

1. 在RabbitMQ 4.0源码目录中，编辑rabbit_amqp1_0.erl，不添加list_local/0函数或不在导出列表中声明它，执行编译并启动节点。
2. 修改rabbit_amqp1_0.erl，添加list_local/0函数并更新导出列表，仅重新编译该模块但不重启RabbitMQ节点。
3. 执行rabbitmqctl status，此时节点仍加载旧版本模块，会触发{:undef, ...}错误。

场景2：分布式集群节点代码不一致 #

1. 搭建两个RabbitMQ 4.0节点组成集群，其中一个节点的rabbit_amqp1_0模块未包含list_local/0函数。
2. 在正常节点的rabbit_networking.erl中添加对rabbit_amqp1_0:list_local/0的调用，编译后重启该节点。
3. 执行rabbitmqctl status，当请求路由到未更新的节点时，会触发错误。

场景3：AMQP 1.0插件未加载 #

1. 执行rabbitmq-plugins disable rabbitmq_amqp1_0禁用AMQP 1.0插件。
2. 修改rabbit_networking.erl，添加对rabbit_amqp1_0:list_local/0的调用，编译并重启节点。
3. 执行rabbitmqctl status，此时rabbit_amqp1_0模块未被加载，会触发未定义错误。

验证方法 #

• 查看模块加载路径：执行rabbitmqctl eval 'code:which(rabbit_amqp1_0).'，确认是否指向最新编译的模块文件。
• 检查函数导出列表：执行rabbitmqctl eval 'rabbit_amqp1_0:module_info(exports).'，确认列表中包含list_local/0。

内容的提问来源于stack exchange，提问作者孙海城