使用七牛云SDK打包报错：com.qiniu.common.Region无法转换为com.qiniu.common.Zone

近日，本人发现，在打包一个使用七牛云SDK（qiniu-java-sdk）的项目时一直报错，报错如下：

[ERROR] COMPILATION ERROR : 
[INFO] -------------------------------------------------------------
[ERROR] /Users/****/IDEAProjects/****/src/main/java/cn/pdf/common/Upload7niu.java:[54,27] 不兼容的类型: com.qiniu.common.Region无法转换为com.qiniu.common.Zone

pom文件中的配置如下：

    <dependency>
      <groupId>com.qiniu</groupId>
      <artifactId>qiniu-java-sdk</artifactId>
      <version>[7.2.0, 7.2.99]</version>
    </dependency>

定位到报错代码行，其实会有点疑惑，因为代码没有进行任何改动，具体报错行为：

Zone z = Zone.autoZone();

而使用“指定具体的要上传的zone”的方法，如Zone z = Zone.zone0()等则不会报这个错。
重新回到报错信息，com.qiniu.common.Region无法转换为com.qiniu.common.Zone，可以看到报错原因是Region无法转换为Zone，而这个错是从2019年5月28日qiniu-java-sdk更新到7.2.19版本后出现的，所以决定去看7.2.19版本的源码，对比7.2.18发现Zone类源码有变动，变动如下：

7.2.18 :

public class Zone {
    ......
    public Zone autoZone() {
        return AutoZone.instance;
    }
    ......
}

7.2.19 :

public class Zone extends Region {
    ......
    /** @deprecated */
    @Deprecated
    public Region autoZone() {
        return super.autoRegion();
    }
    ......
}

这边最大的变动是7.2.19中Zone开始继承Region这个类，并且在autoZone方法中调用Region的autoRegion方法，返回一个Region的对象。
看到这，我想到的解决方法有三个：

指定上传空间

    //要上传的空间(bucket)的存储区域为华东时
    Zone z = Zone.zone0();
    //要上传的空间(bucket)的存储区域为华北时
    Zone z = Zone.zone1();
    //要上传的空间(bucket)的存储区域为华南时
    Zone z = Zone.zone2();

对Zone.autoZone()强制转换类型

    Zone z = (Zone) Zone.autoZone();

指定qiniu-java-sdk版本，7.2.18及之前版本

    <!-- 写死版本号 -->
    <dependency>
      <groupId>com.qiniu</groupId>
      <artifactId>qiniu-java-sdk</artifactId>
      <version>7.2.18</version>
    </dependency>

在5月28日后，我也有一直关注着这个问题，网上似乎都没有任何反馈，Maven仓库中6月1日上传的7.2.20和6月3日上传的7.2.21都存在相同问题，直到6月4日上传的7.2.22才解决问题，进入SDK查看源码发现Zone类又改回7.2.18那样，不再继承Region这个类。至此，各位开发者又可以将pom文件中版本号再次改回[7.2.0, 7.2.99]，可以第一时间享受新版本的特性。
希望能帮到遇到相同问题的开发者们，以及提醒即将使用七牛云的开发者尽量避免使用上述三个有问题版本的SDK。
本文为小小程序员Crismall原创，希望多多支持，如有不足，也希望能及时指出，给我一些帮助。

使用七牛云SDK打包报错：com.qiniu.common.Region无法转换为com.qiniu.common.Zone

推荐阅读更多精彩内容