spring-boot-starter-amqp 不能替代 rabbitmq-client，因其仅为 AMQP 抽象封装，不包含底层通信实现；必须显式引入兼容版本的 rabbitmq-client，并排除 starter 的默认传递依赖，否则易引发类冲突或连接失败。
为什么 spring-boot-starter-amqp 不能直接替代 rabbitmq-client
很多 Java 项目加了 spring-boot-starter-amqp 就以为 RabbitMQ 客户端齐活了，结果一跑连接代码就报 NoClassDefFoundError: com/rabbitmq/client/ConnectionFactory。这不是 Spring Boot 版本问题，而是这个 starter 只是“胶水”——它不自带底层客户端实现，必须显式引入 rabbitmq-client。
-
spring-boot-starter-amqp是 Spring 对 AMQP 协议的抽象封装，依赖org.springframework.amqp包，不包含任何 RabbitMQ 具体通信逻辑 -
rabbitmq-client才是真正负责 TCP 连接、帧解析、心跳维持的 SDK，版本需与 RabbitMQ 服务端兼容（例如 3.13.x 服务端建议用rabbitmq-client 5.20.0+） - Spring Boot 3.x 默认拉取的
rabbitmq-client版本偏旧（如 5.18.0），若服务端启用了 TLS 1.3 或 QUIC 实验特性，可能握手失败
Gradle 中两个依赖怎么写才不冲突
常见错误是只写 spring-boot-starter-amqp，或手动引入高版本 rabbitmq-client 后和 starter 自带的低版本发生类路径冲突，导致 Channel 方法找不到、ShutdownSignalException 频发。
- 必须同时声明两者，且用
exclude切断 starter 的默认 client 传递依赖：implementation('org.springframework.boot:spring-boot-starter-amqp') { exclude group: 'com.rabbitmq', module: 'amqp-client' } implementation 'com.rabbitmq:amqp-client:5.20.0' - Maven 用户对应用
<exclusions>块，别漏掉module名是amqp-client（不是rabbitmq-client） - 如果项目还用了
spring-cloud-stream-binder-rabbit，它也带 client 依赖，同样要 exclude，否则三重叠加极易引发MethodNotFound
ConnectionFactory 初始化时哪些参数实际生效
Spring Boot 的 application.yml 里配的 spring.rabbitmq.host 看似方便，但一旦你要调用 setAutomaticRecoveryEnabled(true) 或自定义 TopologyRecovery，就必须手写 ConnectionFactory Bean——因为 auto-configuration 不暴露这些底层开关。
-
setConnectionTimeout(30000)和setHandshakeTimeout(30000)必须显式设，否则默认 10 秒，在网络抖动时容易连不上就抛IOException -
setAutomaticRecoveryEnabled(true)开启后，setNetworkRecoveryInterval(10000)才有意义；但 recovery 不会重连已关闭的Channel，应用层仍需捕获ShutdownSignalException并重建 - 使用 TLS 时，
useSslProtocol("TLSv1.2")必须早于newConnection()调用，放在 builder 链式调用末尾会失效
本地启动 RabbitMQ 服务时端口和服务名别想当然
很多人用 Docker 跑 rabbitmq:management 镜像，以为 localhost:5672 肯定通，结果连不上。根本原因常是：Docker 网络模式、SELinux 限制、或 management 插件没开 AMQP 端口。
立即学习“Java免费学习笔记（深入）”；
- Docker 默认 bridge 模式下，Java 应用若也在容器里，不能连
localhost:5672，得用宿主机 IP 或host.docker.internal:5672（Mac/Windows 支持，Linux 需加--add-host=host.docker.internal:host-gateway） - 镜像标签选错：
rabbitmq:3-management是旧版，默认开 5672；rabbitmq:4-management默认禁用 classic queue，AMQP 连接会直接被拒，需额外加环境变量RABBITMQ_SERVER_ADDITIONAL_ERL_ARGS="-rabbitmq_management listener [{port,15672}] -rabbitmq_amqp10 listener [{port,5672}]" - 首次启动后，务必访问
http://localhost:15672，用 guest/guest 登录，在 Admin → Virtual Hosts 页面确认/vhost 已启用，且用户权限已绑定
AMQP 连接失败时先看日志里有没有 CONNECTION_FORCED - broker forced connection closure，这大概率是 vhost 权限或认证问题，不是依赖或代码的事。
