rocketmq启动失败主因是java环境配置错误、jvm内存与系统限制不匹配、docker网络配置不当及broker ip设置错误；需校准java_home、调低xms/xmx、修改系统文件句柄数、用host.docker.internal代替localhost、启用autocreatetopicenable并正确配置brokerip1。
Java环境没配对，RocketMQ根本起不来
RocketMQ是纯Java写的，JDK 8+是硬门槛，但很多人卡在JDK版本和系统默认Java不一致上。比如Mac装了JDK 17，终端里java -version显示的是17，但sh bin/mqnamesrv却报UnsupportedClassVersionError——说明启动脚本实际调用的是系统自带的旧JDK（如JDK 8）。
- 检查
$JAVA_HOME是否指向你安装的JDK目录，不是/usr/bin/java - 在
bin/runserver.sh和bin/runbroker.sh开头加一行：export JAVA_HOME=/path/to/your/jdk - Mac用户特别注意：用Homebrew装的JDK路径通常是
/opt/homebrew/opt/openjdk或/opt/homebrew/Cellar/openjdk/xx，别直接抄网上“/Library/Java/…”
单机启动失败，98%是因为JVM内存和系统限制没调
默认配置里runserver.sh用-Xms4g -Xmx4g，8G内存的开发机一跑就OOM；更隐蔽的是Linux系统级文件句柄限制，不改limits.conf，Broker启动几秒后自动退出，日志里只有Too many open files。
- 先改JVM：用
sed -i 's/-Xms4g -Xmx4g/-Xms256m -Xmx256m/g' bin/runserver.sh bin/runbroker.sh - 再调系统限制：
echo "* soft nofile 65536" >> /etc/security/limits.conf，然后重启终端或重新登录 - Mac用户不用改
limits.conf，改launchctl limit maxfiles，但更简单的是直接用Docker——见下一条
Docker方式启动最省事，但NameServer地址容易写错
本地开发图快，用Docker是最稳的，但NAMESRV_ADDR写成localhost:9876在Java客户端里会连不上——因为容器内localhost指自己，不是宿主机。
- 启动NameServer：
docker run -d -p 9876:9876 --name rmqnamesrv rocketmqinc/rocketmq sh mqnamesrv - 启动Broker时必须用宿主机IP：
docker run -d -p 10911:10911 --name rmqbroker --link rmqnamesrv:namesrv -e "NAMESRV_ADDR=host.docker.internal:9876" rocketmqinc/rocketmq sh mqbroker -c /home/rocketmq/conf/broker.conf - Java代码里
producer.setNamesrvAddr("host.docker.internal:9876")，Windows/Mac可用，Linux需换为宿主机真实IP
消息发不出去？先看autoCreateTopicEnable和brokerIP1
新手常遇到org.apache.rocketmq.client.exception.MQClientException: No route info of this topic，表面是Topic不存在，根因其实是Broker没暴露正确IP，或者自动建Topic被关了但没手动创建。
立即学习“Java免费学习笔记（深入）”；
- 开发阶段把
conf/broker.conf里autoCreateTopicEnable=true（生产环境必须关） - 务必设置
brokerIP1为本机可访问的IP，不是127.0.0.1，也不是内网虚拟IP（如Docker网桥IP） - 如果用
mqadmin工具手动建Topic，命令是：sh bin/mqadmin updateTopic -n localhost:9876 -t test_topic -c DefaultCluster
Broker的IP配置和NameServer地址匹配问题，在本地多网卡、虚拟机、Docker混合场景下极难排查，建议第一次跑通前先用ping和telnet确认端口连通性，别急着写代码。
