Web3j生成Wrapper类报错：找不到LinkReference类及包名错误

我在开发一个与以太坊智能合约交互的Spring Boot项目，使用Web3j编译Solidity合约并生成ABI、二进制文件及Java包装类，但生成的代码存在以下问题：

1. 编译错误：

/home/abdulmueedshahbaz/springboot/eth/eth/src/main/java/generated/com/zuehlke/blockchain/model/HelloWorld.java:204:51
java: cannot find symbol
  symbol:   class LinkReference
  location: class org.web3j.tx.Contract

2. 包名错误：生成的包装类包名与项目结构冲突，无法正常导入。

这些问题导致Spring Boot应用无法构建运行。

环境配置 #

Maven依赖 #

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter</artifactId>
    </dependency>
    <dependency>
        <groupId>org.web3j</groupId>
        <artifactId>core</artifactId>
        <version>5.0.0</version>
    </dependency>
    <dependency>
        <groupId>org.web3j</groupId>
        <artifactId>crypto</artifactId>
        <version>5.0.0</version>
    </dependency>
    <dependency>
        <groupId>org.web3j</groupId>
        <artifactId>utils</artifactId>
        <version>5.0.0</version>
    </dependency>
    <dependency>
        <groupId>org.web3j</groupId>
        <artifactId>abi</artifactId>
        <version>5.0.0</version>
    </dependency>
    <dependency>
        <groupId>com.fasterxml.jackson.core</groupId>
        <artifactId>jackson-databind</artifactId>
        <version>2.18.2</version>
    </dependency>
</dependencies>

Maven构建插件 #

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
        <plugin>
            <groupId>org.web3j</groupId>
            <artifactId>web3j-maven-plugin</artifactId>
            <version>4.12.3</version>
            <configuration>
                <packageName>com.zuehlke.blockchain.model</packageName>
                <sourceDestination>src/main/java/generated</sourceDestination>
                <nativeJavaType>true</nativeJavaType>
                <outputFormat>java,bin</outputFormat>
                <soliditySourceFiles>
                    <directory>src/main/resources/solidity/</directory>
                    <includes>
                        <include>**/*.sol</include>
                    </includes>
                </soliditySourceFiles>
                <outputDirectory>
                    <java>src/main/java/generated</java>
                    <bin>src/bin/generated</bin>
                    <abi>src/abi/generated</abi>
                </outputDirectory>
                <contract>
                    <includes>
                        <include>HelloWorld</include>
                    </includes>
                    <excludes>
                        <exclude>mortal</exclude>
                    </excludes>
                </contract>
                <pathPrefixes>
                    <pathPrefix>dep=../dependencies</pathPrefix>
                </pathPrefixes>
            </configuration>
        </plugin>
    </plugins>
</build>

操作步骤 #

• 将Solidity文件放入src/main/resources/solidity/目录
• 执行mvn web3j:generate-sources命令生成ABI、二进制文件及包装类
• 尝试构建并运行应用

具体问题与解决方案 #

1. 缺少LinkReference类的编译错误 #

原因：Web3j Maven插件版本（4.12.3）与Web3j核心依赖版本（5.0.0）不兼容。插件生成的代码引用了LinkReference类，但该类在Web3j 5.0.0的org.web3j.tx.Contract中不存在，版本差异导致API不匹配。

解决方法：

• 统一Web3j所有组件的版本：将Maven插件版本改为5.0.0，与核心依赖版本保持一致；或者将所有Web3j依赖版本降级到4.12.3，匹配插件版本。
• 修改后的插件配置示例（统一为5.0.0）：

<plugin>
    <groupId>org.web3j</groupId>
    <artifactId>web3j-maven-plugin</artifactId>
    <version>5.0.0</version>
    <!-- 其余配置保持不变 -->
</plugin>

2. 包名与项目结构冲突 #

原因：插件配置中packageName与sourceDestination的组合导致生成的类路径不符合项目预期。当前配置下，类会生成在src/main/java/generated/com/zuehlke/blockchain/model/，若项目中已有com.zuehlke.blockchain.model包，会引发冲突。

解决方法：

• 调整packageName为项目专属的生成类包名，例如com.zuehlke.blockchain.model.generated，同时将sourceDestination设为src/main/java，这样生成的类会自动放在src/main/java/com/zuehlke/blockchain/model/generated/目录下，与现有代码隔离。
• 修改后的配置示例：

<configuration>
    <packageName>com.zuehlke.blockchain.model.generated</packageName>
    <sourceDestination>src/main/java</sourceDestination>
    <!-- 其余配置保持不变 -->
</configuration>

3. Web3j 5.0.0与Solidity的兼容性问题 #

Web3j 5.0.0对Solidity的支持范围主要是0.5.x至0.7.x版本。若使用Solidity 0.8.x及以上版本，可能出现语法解析、ABI生成异常等兼容性问题。建议：

• 若使用高版本Solidity，升级Web3j依赖及插件至对应兼容版本（如Web3j 4.10+开始支持Solidity 0.8.x）；
• 若坚持使用Web3j 5.0.0，将Solidity合约版本降级至0.7.x及以下。

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