请求协助：Apache Unomi与Salesforce集成及连接器激活问题

1. 版本匹配修正 #

Unomi 2.4.0与2.5.0-SNAPSHOT版本的Salesforce连接器存在依赖版本不兼容问题，请勿跨版本安装快照版特性。请使用与Unomi主版本一致的2.4.0版本Salesforce连接器。

2. 清理异常Bundle并通过Feature重新安装 #

步骤1：定位异常Bundle #

在Karaf Shell中执行以下命令，列出所有Salesforce相关的异常Bundle：

bundle:list -s | grep salesforce

记录状态为Failure或Installed的Bundle ID。

步骤2：卸载异常组件 #

卸载所有异常的Salesforce Bundle及手动安装的依赖：

bundle:uninstall <bundle-id-1> <bundle-id-2> ...

步骤3：添加对应版本的Unomi Feature仓库 #

添加Unomi 2.4.0官方Feature仓库（确保容器能访问Maven中央仓库）：

feature:repo-add unomi org.apache.unomi.unomi-features/2.4.0

步骤4：安装Salesforce连接器Feature #

通过Feature机制自动处理依赖，执行：

feature:install unomi-salesforce-connector

执行完成后再次用bundle:list检查，所有Salesforce相关Bundle应处于Active状态。

3. 解决依赖循环问题 #

若之前手动安装依赖导致组件缺失循环，需彻底清理所有相关非官方安装的Bundle，再通过上述Feature安装流程重新部署——Feature机制会自动解析并安装完整的依赖链，避免手动安装的依赖冲突。

4. Salesforce连接API故障排查 #

步骤1：验证配置文件 #

检查Unomi配置目录下的etc/org.apache.unomi.salesforce.cfg，确保以下参数配置正确：

• client.id：Salesforce应用的客户端ID
• client.secret：Salesforce应用的客户端密钥
• username：Salesforce授权用户账号
• password：Salesforce账号密码 + 安全令牌（若未设置IP白名单）
• loginUrl：Salesforce登录地址（如https://login.salesforce.com）

步骤2：重启连接器Bundle #

修改配置后，重启Salesforce连接器Bundle：

bundle:restart <salesforce-connector-bundle-id>

步骤3：日志排查 #

通过Karaf Shell查看实时日志，定位连接报错的具体原因：

log:tail

常见问题包括：

• Azure VM IP未加入Salesforce IP白名单
• Salesforce凭证过期或权限不足（需确保账号有API访问权限）
• 配置文件参数拼写错误

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