docker-compose部署的RabbitMQ 3.7如何修改最大消息大小为2GB

首先明确：RabbitMQ 3.7版本支持修改默认最大消息大小，你之前配置未生效通常是配置项错误、挂载异常、未重启实例三个原因导致，具体操作步骤如下：

1. 编写正确的配置项 #

在你本地挂载的rabbitmq.conf文件中添加如下配置，2GB对应的字节数为2147483648，直接填入即可：

rabbitmq.max_message_size = 2147483648

注意：不要使用Erlang语法的.config格式编写配置，3.7版本默认读取key=value格式的rabbitmq.conf，格式错误会导致配置不加载

2. 验证配置挂载有效性 #

启动容器后执行以下命令，确认配置已被正确读取：

# 进入RabbitMQ容器
docker exec -it rabbitMQ bash
# 查看已加载的max_message_size配置
rabbitmqctl environment | grep max_message_size

如果返回值不是你设置的2147483648，检查两点：

• 本地rabbitmq.conf是否和docker-compose.yml放在同级目录
• 本地配置文件的读取权限是否正常，可执行chmod 644 rabbitmq.conf修正权限

3. 重启实例让配置生效 #

max_message_size属于启动时加载的配置，不支持热重载，修改配置后必须重启容器：

docker-compose down && docker-compose up -d

生产环境注意事项 #

• 2GB属于超大消息，会大幅占用RabbitMQ的内存、磁盘IO资源，建议调整前先完成压测，同时在docker-compose的environment节点添加内存上限配置，避免OOM：

  environment:
    - RABBITMQ_VM_MEMORY_HIGH_WATERMARK=0.7
  

  上述配置代表允许RabbitMQ最高使用宿主机70%的内存
• 如果是集群部署，所有节点的max_message_size配置必须保持一致，否则跨节点同步消息时会出现大小超限报错
• 你当前docker-compose配置中5672端口是注释状态，如果你的业务服务需要从宿主机访问RabbitMQ，需要放开该端口映射

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