WSO2 APIM 2.6.0与Analytics集成报错：loganalyzer流定义缺失求助

首先明确：WSO2 APIM 2.6.0和对应的WSO2 API Manager Analytics 2.6.0是完全兼容的，但必须严格遵守迁移文档要求——使用经过WUM（WSO2 Update Manager）更新的Analytics包，这是避免版本不兼容问题的核心前提。

报错原因拆解 #

你碰到的No StreamDefinition for streamId loganalyzer:1.0.0 present in cache错误，本质是Analytics服务器中缺失loganalyzer:1.0.0事件流的定义，导致无法解析APIM发送的事件。大概率由以下几个原因触发：

• Analytics版本不匹配/未更新：若使用的不是APIM 2.6.0对应的Analytics 2.6.0版本，或未通过WUM安装补丁，流定义可能未被正确包含，或与APIM的事件格式不兼容。
• 关键Carbon App部署异常：APIM的LogAnalyzer事件依赖Analytics中部署的特定Carbon App接收处理，该App包含loganalyzer:1.0.0等流定义。若App未部署、部署失败或版本不匹配，就会出现流定义缺失。
• 缓存加载失败：Analytics启动时若Carbon App部署出错，流定义缓存无法正常加载，后续接收事件时就会触发报错。

具体解决步骤 #

1. 确认Analytics版本与更新状态

• 必须使用WSO2 API Manager Analytics 2.6.0版本，且已通过WUM完成所有必要更新。未更新的基础包可能存在流定义缺失的bug。
• 验证方法：启动Analytics后，查看carbon.log开头的版本信息，确认版本为2.6.0且包含WUM更新的补丁标识。

2. 检查并重新部署APIM Analytics Carbon App

• APIM 2.6.0对应的Analytics需要部署apim-analytics-2.6.0.car（或WUM更新后的对应包），该包包含所有所需流定义，包括loganalyzer:1.0.0。
• 操作步骤：
  1. 停止Analytics服务器。
  2. 检查<ANALYTICS_HOME>/repository/deployment/server/carbonapps目录是否存在正确的APIM Analytics Carbon App包，若缺失则从官方发布的Analytics 2.6.0包（或WUM更新包）中复制。
  3. 删除<ANALYTICS_HOME>/repository/deployment/server/carbonapps/.carbonapps目录，清理部署缓存。
  4. 重启Analytics服务器，查看carbon.log中是否有类似Successfully deployed carbon app apim-analytics-2.6.0的日志，确认App部署成功。

3. 验证APIM侧的事件发送配置

• 检查APIM的<APIM_HOME>/repository/conf/datasources/analytics-datasources.xml，确保Analytics的连接信息（主机、端口、账号密码）配置正确。
• 查看<APIM_HOME>/repository/conf/log4j2.properties，确认loganalyzer相关的appender配置正确指向Analytics，且未被注释。

4. 清理缓存后重启服务

• 停止APIM和Analytics服务器。
• 清理APIM的<APIM_HOME>/repository/tmp和<APIM_HOME>/repository/work目录。
• 清理Analytics的<ANALYTICS_HOME>/repository/tmp、<ANALYTICS_HOME>/repository/work目录；若使用嵌入式H2数据库，可同步清理<ANALYTICS_HOME>/database（生产环境使用外部数据库如MSSQL时，需确保数据库连接正常）。
• 先启动Analytics服务器，待其完全启动（日志显示WSO2 Carbon started in X seconds）后，再启动APIM服务器。

额外提醒 #

• 若使用外部数据库（如你提到的MSSQL），需确保Analytics的数据库脚本已正确执行，所有必要的表（包括流定义相关表）已创建完成。
• 检查防火墙与网络配置，确保APIM能正常连接到Analytics的Thrift端口（默认7611、7711）。

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