根本原因是jdk版本与tomcat不匹配，如jdk 17运行tomcat 9或jdk 8运行tomcat 10.1+；需检查catalina.sh version、setenv.sh中java_home及java -version输出，并确认版本兼容性要求。
Tomcat启动失败报 java.lang.UnsupportedClassVersionError
根本原因是JDK版本和Tomcat不匹配。比如用JDK 17运行Tomcat 9，或用JDK 8运行Tomcat 10.1+，都会触发这个错误。
检查方式很简单：catalina.sh version 或直接看 $CATALINA_HOME/bin/setenv.sh（如果存在）里是否硬编码了 JAVA_HOME；再对比 java -version 输出的实际版本。
- Tomcat 9 最低要求 JDK 8，但推荐 JDK 11+
- Tomcat 10.1.x 要求 JDK 11+，且必须是 JDK 17 才能启用 Servlet 6.0 新特性
- 别在
/etc/profile里只配JAVA_HOME就完事——Tomcat 启动脚本会优先读setenv.sh，它里面若写了JAVA_HOME=/wrong/path，系统级环境变量就失效了
KAFKA_HOME 不是必须的，但 KAFKA_OPTS 很关键
Kafka 官方脚本不依赖 KAFKA_HOME 环境变量，bin/kafka-server-start.sh 是靠当前路径和 dirname 推导出配置目录的。强行设 KAFKA_HOME 反而容易误导自己。
真正影响 Kafka 运行的是 JVM 参数：KAFKA_OPTS 决定堆内存、GC 策略、JMX 暴露等。例如：
KAFKA_OPTS="-Xms2g -Xmx2g -XX:+UseG1GC -Dcom.sun.management.jmxremote"
常见坑：
- 没设
KAFKA_OPTS，Kafka 默认只用 1G 堆，在高吞吐场景下频繁 GC 甚至 OOM - 在
server.properties里改了listeners，但忘了同步调整advertised.listeners，导致 Tomcat 里的生产者连不上 broker - 把 Kafka 和 ZooKeeper 都跑在一台机器上，又没调大
vm.max_map_count（Linux），kafka-server-start.sh启动时卡住无报错
Tomcat 应用连接 Kafka 时连不上 localhost:9092
这不是网络问题，而是 Kafka 的监听地址语义陷阱。listeners=PLAINTEXT://:9092 表示“监听所有网卡的 9092”，但 advertised.listeners=PLAINTEXT://localhost:9092 会告诉客户端：“你该连 localhost”。Tomcat 如果部署在另一台机器，或容器里，localhost 就解析成它自己，不是 Kafka 所在机器。
解决办法只有改 advertised.listeners 为可被外部访问的真实 IP 或域名：
advertised.listeners=PLAINTEXT://192.168.10.5:9092
同时确保：
- 防火墙放行 9092 端口（
ufw allow 9092或firewall-cmd --add-port=9092/tcp） - Tomcat 应用的
bootstrap.servers配置值，必须和advertised.listeners完全一致 - 不要在开发机上用 Docker 启 Kafka 却让 Tomcat 直连
host.docker.internal——这在 Linux 上默认不存在，得手动加--add-host=host.docker.internal:host-gateway
日志采集链路中 Tomcat 和 Kafka 的时区/时间戳对齐
Filebeat 采集 localhost_access_log，发到 Kafka，再由 Flink 或 Logstash 消费——如果各环节时间戳格式不统一，按时间窗口聚合就会错乱。
Tomcat 访问日志默认用系统本地时区，而 Kafka 消息头时间戳（timestamp 字段）是毫秒级 long，由生产者写入时决定。两者不自动对齐。
建议做法：
- 统一所有节点系统时区为
UTC：timedatectl set-timezone UTC - 在
server.xml的AccessLogValve中显式指定时区：pattern='{"@timestamp":"%{yyyy-MM-dd HH:mm:ss.SSS Z}t", ...}' - Kafka 生产者代码里不要依赖
System.currentTimeMillis()，改用Clock.systemUTC().millis()（Java 8+）
最容易被忽略的是：Filebeat 的 processors.timestamp 默认用本地时区解析日志时间，必须显式设 timezone: "UTC"，否则日志体里是 UTC，Filebeat 解析成 CST，差 8 小时。
