Vertx 3.5.1生成服务代理代码编译失败：未捕获UnsupportedEncodingException

这个问题我之前帮同事排查过类似的，本质是Vert.x 3.5.1版本的代理代码生成器在处理受检异常时的一个小bug。咱们一步步来解决：

问题根源 #

UnsupportedEncodingException是Java的受检异常，按照Java语法，要么在方法签名里用throws声明它，要么在代码里用try/catch捕获。而生成的代理代码里直接写了throw t（这里的t就是这个受检异常），却没在对应的方法上声明抛出该异常，所以编译器直接报错了。

具体解决方法 #

1. 手动修正生成的代理代码 #

找到报错的那个方法，两种改法任选其一：

• 方法一：声明异常
  在方法签名末尾加上throws java.io.UnsupportedEncodingException，让编译器知道这个方法会抛出该异常。比如：

  // 原来的方法
  public void yourProxyMethod() {
      try {
          // 生成的编码相关逻辑
      } catch (UnsupportedEncodingException t) {
          throw t; // 这里报错
      }
  }
  
  // 修改后
  public void yourProxyMethod() throws UnsupportedEncodingException {
      try {
          // 生成的编码相关逻辑
      } catch (UnsupportedEncodingException t) {
          throw t;
      }
  }
  

• 方法二：包装成非受检异常
  如果不想在方法上声明throws，可以把受检异常包装成RuntimeException，这样编译器就不会强制要求处理它：

  public void yourProxyMethod() {
      try {
          // 生成的编码相关逻辑
      } catch (UnsupportedEncodingException t) {
          throw new RuntimeException("编码处理失败", t); // 包装成RuntimeException
      }
  }
  

2. 检查自定义服务接口（如果是基于自定义接口生成代理） #

如果你是用自己写的服务接口生成代理，确保接口里的方法如果可能抛出UnsupportedEncodingException，已经提前声明了throws。比如：

// 你的服务接口
public interface YourService {
    void someMethod() throws UnsupportedEncodingException; // 提前声明异常
}

这样Vert.x的代码生成器在生成代理时，会自动继承这个throws声明，就不会出现编译错误了。

3. 升级Vert.x版本（推荐） #

Vert.x 3.5.1是2017年的老版本了，后续的3.9.x或者更高稳定版本已经修复了不少代码生成相关的bug。如果项目允许的话，升级到较新的版本，这个问题大概率会直接消失，还能获得其他功能和稳定性提升。

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