使用TeaVM将Java库转为WebAssembly时导出函数失败求助

问题分析 #

你遇到的核心问题是：用@Export注解的函数没出现在生成的WASM文件里，大概率是TeaVM的优化机制把未被引用的函数删掉了，或者配置/代码有不符合导出要求的地方。

具体修复步骤 #

1. 调整优化级别，避免函数被误删 #

你用了<optimizationLevel>FULL</optimizationLevel>，这个级别的优化会把所有没被直接调用的代码都砍掉——哪怕你加了@Export注解。

修复方式二选一：

• 把优化级别降到SIMPLE，这个级别会保留被@Export标记的函数：

  <optimizationLevel>SIMPLE</optimizationLevel>
  

• 或者在插件配置里强制指定要保留的方法，精准避免被优化移除：

  <configuration>
      <!-- 保留你原来的配置 -->
      <keepMethods>
          <!-- 替换成你自己的类全路径+方法签名 -->
          <method>com.your.package.YourClass.getMagicNumber(int)</method>
      </keepMethods>
  </configuration>
  

2. 把实例方法改成静态方法（更稳妥） #

你现在的getMagicNumber是实例方法，WASM本身不直接支持Java对象实例的管理，TeaVM处理实例方法导出会更复杂，容易出问题。改成静态方法是最直接的：

import org.teavm.interop.Export;

// 其他代码

@Export(name = "getMagicNumber")
public static int getMagicNumber(int range) {
    return range * 2;
}

// 其他代码

3. 补全TeaVM依赖 #

你只加了teavm-classlib，0.8.1版本里还需要teavm-core才能完整支持WASM导出，把这个依赖加上：

<dependency>
    <groupId>org.teavm</groupId>
    <artifactId>teavm-core</artifactId>
    <version>0.8.1</version>
</dependency>

4. 给TeaVM一个明确的编译入口（可选） #

如果你的项目没有明确的主类，TeaVM可能不知道要编译哪些代码。可以指定一个空的主类，只要它引用了你的导出方法所在的类就行：

<configuration>
    <!-- 其他配置 -->
    <mainClass>com.your.package.DummyMain</mainClass>
</configuration>

然后创建这个DummyMain类：

public class DummyMain {
    // 引用目标类，确保TeaVM编译时包含它
    private static YourClass placeholder = new YourClass();
}

验证 #

改完之后重新跑mvn clean package，再用wasm2wat打开生成的WASM文件，就能看到(export "getMagicNumber" (func ...))的导出定义了。

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