WSO2 Integration Studio 8.0.1导入项目报连接器错误如何解决

按以下顺序逐一操作，绝大多数连接器加载失败问题都能解决：

• 清理本地缓存（单纯重启Studio不会清理这部分缓存，是最容易被忽略的步骤）
  1. 完全退出Integration Studio进程
  2. 打开Studio工作空间根目录，删除3个缓存路径下的所有文件：
     • .metadata/.plugins/org.eclipse.wst.server.core/tmp* （服务临时部署缓存）
     • .metadata/.plugins/org.wso2.integrationstudio.connector.core （本地连接器索引缓存）
     • 导入的目标项目目录下的隐藏文件夹.connector
  3. 右键点击Integration Studio启动程序，选择管理员/root权限启动，避免权限不足导致连接器文件无法正常写入
• 校验项目内连接器配置正确性
  1. 打开项目结构，确认Gmail连接器不是添加在全局连接器库，必须放在当前项目的Connector Exporter目录下：如果项目没有该目录，先右键项目 -> New -> Connector Exporter新建；再右键该目录 -> Add Connector，选择对应版本的Gmail连接器
  2. 重点校验版本匹配：本地项目添加的Gmail连接器版本，必须和服务端部署的连接器版本完全一致，小版本号差一位都会导致加载失败
  3. 连接器添加完成后，右键项目 -> Maven -> Update Project，勾选Force Update of Snapshots/Releases，等待依赖拉取完成，不要跳过该步骤
• 修复项目导入导致的配置缺失问题
  1. 如果是导入外部旧项目触发的报错，不要反复重试直接导入：先新建一个同运行时版本的空Integration项目，把旧项目里的API、序列、端点等业务代码手动复制到新项目对应目录，再按上述步骤重新添加Gmail连接器
  2. 打开项目根目录下的pom.xml，确认存在Gmail连接器的依赖条目，缺失则手动补充，格式参考：

     <dependency>
       <groupId>org.wso2.carbon.connector</groupId>
       <artifactId>gmail-connector</artifactId>
       <version>替换为你实际使用的连接器版本号，例如4.0.3</version>
       <type>carbon-application</type>
     </dependency>
     

  3. 打开项目根目录下的隐藏文件.project，确认构建配置里存在org.wso2.integrationstudio.connector.core.nature条目，缺失的话可以从其他正常加载连接器的项目里复制对应配置段补充
• 服务端连接器配置校验
  1. 确认Gmail连接器的jar包是放在Micro Integrator运行目录的<MI_HOME>/dropins路径下，不要放在其他自定义目录
  2. 放完连接器包后重启MI服务，登录管理控制台进入连接器列表页，确认Gmail连接器状态为Active，如果显示Installed或Error，删除dropins下的对应jar包重新上传、重启，直到状态正常

全部操作完成后，右键项目 -> Run As -> Run on Integration Server，启动日志中没有出现Gmail相关的ClassNotFound、Unknown connector类报错，就说明连接器加载成功，原有导入错误会自动清除。

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