Karaf 3.0.1执行feature:repo-add时忽略本地Maven仓库求助

我之前在Karaf 3.x版本上也碰到过类似的问题，结合你的场景，以下是几个最可能的原因及排查方向：

1. 配置文件修改后未生效或配置错误 #

你提到已经修改了etc/org.ops4j.pax.url.mvn.cfg，但有可能配置没有正确加载，或者参数写错了：

• 首先确认修改的配置是否生效：启动Karaf后执行命令

  config:list | grep -A 15 org.ops4j.pax.url.mvn
  

  查看输出中的org.ops4j.pax.url.mvn.localRepository和org.ops4j.pax.url.mvn.repositories参数是否和你配置的一致。
• 检查本地仓库路径格式：Linux/macOS下正确的路径应该是file:///home/你的用户名/.m2/repository（注意三个斜杠），Windows下是file:///C:/Users/你的用户名/.m2/repository，如果漏写file://前缀，Karaf可能无法识别这是本地路径。
• 仓库优先级问题：确保org.ops4j.pax.url.mvn.repositories中本地仓库排在中央仓库前面，比如：

  org.ops4j.pax.url.mvn.repositories=file://${user.home}/.m2/repository@id=local,http://repo1.maven.org/maven2@id=central
  

  这样Karaf会优先从本地仓库查找构件。

2. 本地Maven仓库中的构件结构不完整 #

你手动确认特性存在，但要确保构件的Maven目录结构和元数据是正确的：

• 检查本地仓库路径：~/.m2/repository/com/mycompany/myproject/common/common-karaf-features/1.1.0/下是否存在common-karaf-features-1.1.0-features.xml文件（对应你命令里的xml/features类型和分类器）。
• 确认Maven元数据：该目录下是否有maven-metadata-local.xml文件，文件中是否正确包含了这个features.xml构件的信息。如果元数据缺失或错误，Karaf会认为本地没有该构件，转而请求中央仓库。

3. Karaf缓存未彻底清理 #

虽然你用了bin/karaf clean启动，但有时候缓存残留还是会影响：

• 停止Karaf，手动删除data/cache目录，然后重新启动。
• 启动后执行feature:repo-refresh命令刷新特性仓库列表，再尝试添加你的特性仓库。

4. 权限问题 #

如果Karaf是用不同用户启动的（比如sudo），可能无法访问当前用户的~/.m2/repository：

• 检查启动Karaf的用户，确保该用户对~/.m2/repository目录有读取权限。
• 如果是用sudo启动，尝试切换到自己的用户重新启动Karaf。

5. 构件坐标或类型错误 #

再仔细核对你执行的命令：

feature:repo-add mvn:com.mycompany.myproject.common/common-karaf-features/1.1.0/xml/features

确认坐标是否完全正确：groupId、artifactId、version、type（xml）、classifier（features）是否和本地仓库中的构件完全匹配。哪怕一个字符写错，Karaf都找不到本地构件，会去中央仓库尝试查找。

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