指定Ballerina依赖版本未生效，自动拉取最新兼容版本咨询

可能原因 #

• 依赖声明格式错误：如果你的Ballerina.toml里依赖写成了wso2healthcare/healthcare.fhir.r4:^0.1.17（带脱字符^），Ballerina会自动拉取同主版本下的最新兼容版本（也就是0.1.18），哪怕你误以为指定了固定版本。
• 间接依赖传递影响：项目中其他依赖可能声明了对healthcare.fhir.r4的更高版本要求，Ballerina的依赖解析器会选择满足所有依赖的最高兼容版本。
• 本地缓存残留：即便删除了Dependencies.toml，Ballerina本地仓库（默认路径~/.ballerina/repositories）可能还缓存了0.1.18版本，编译时会优先使用缓存的兼容版本。

解决办法 #

1. 修正依赖声明格式
   打开Ballerina.toml，确保依赖是固定版本写法，不要带版本范围符号：

   [[dependencies]]
   org = "wso2healthcare"
   name = "healthcare.fhir.r4"
   version = "0.1.17"
   

   或者用短格式：

   dependencies = [
       "wso2healthcare/healthcare.fhir.r4:0.1.17"
   ]
   

2. 强制锁定依赖版本
   如果是间接依赖导致的版本升级，可在Ballerina.toml中添加[[overrides]]节点强制锁定：

   [[overrides]]
   org = "wso2healthcare"
   name = "healthcare.fhir.r4"
   version = "0.1.17"
   

   这个配置会强制所有依赖都使用指定的0.1.17版本，忽略其他传递依赖的版本要求。

3. 清理缓存后重新构建

   • 删除项目根目录下的target文件夹和Dependencies.toml
   • 清理本地仓库中该依赖的高版本缓存：

     rm -rf ~/.ballerina/repositories/central.ballerina.io/wso2healthcare/healthcare.fhir.r4/0.1.18
     

   • 重新执行构建：

     bal build
     

4. 验证依赖版本
   构建完成后，查看生成的Dependencies.toml确认版本是否为0.1.17；也可通过bal graph dependencies命令查看依赖树，检查版本是否正确。

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