Fabric Java链码容器启动失败：合约类缺失Main方法问题排查

问题原因 #

你的链码类mypackage.MyChaincodeClass仅实现了ContractInterface并使用合约注解，本身没有定义main方法，但maven-shade插件将该类指定为Jar包的Main-Class，导致JVM执行时找不到程序入口，从而抛出错误。

Fabric Java链码的启动逻辑由框架提供的专用类负责，无需自行编写main方法。

解决方案 #

1. 修正maven-shade插件配置 #

修改pom.xml中的maven-shade插件，将Main-Class替换为Fabric框架提供的启动类org.hyperledger.fabric.contract.ContractRouter，同时添加AppendingTransformer合并SPI配置文件（这是框架发现合约类的关键）：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-shade-plugin</artifactId>
    <version>3.1.0</version>
    <executions>
        <execution>
            <phase>package</phase>
            <goals>
                <goal>shade</goal>
            </goals>
            <configuration>
                <finalName>chaincode</finalName>
                <transformers>
                    <!-- 指定框架提供的启动类 -->
                    <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                        <mainClass>org.hyperledger.fabric.contract.ContractRouter</mainClass>
                    </transformer>
                    <!-- 合并SPI配置文件，确保框架能发现你的合约类 -->
                    <transformer implementation="org.apache.maven.plugins.shade.resource.ServicesResourceTransformer"/>
                </transformers>
                <filters>
                    <filter>
                        <artifact>*:*</artifact>
                        <excludes>
                            <exclude>META-INF/*.SF</exclude>
                            <exclude>META-INF/*.DSA</exclude>
                            <exclude>META-INF/*.RSA</exclude>
                        </excludes>
                    </filter>
                </filters>
            </configuration>
        </execution>
    </executions>
</plugin>

2. 重新构建链码Jar包 #

执行Maven命令重新打包：

mvn clean package

3. 验证本地运行 #

重新生成的Jar包执行java -jar chaincode.jar，应不再抛出main方法缺失的错误，会提示需要链码启动参数（这是正常现象，因为链码需要在Fabric容器环境中接收节点的连接参数）。

4. 链码部署注意事项 #

由于你的合约未使用@Default注解，在提交链码时，需显式指定合约类：

peer chaincode instantiate -o orderer.example.com:7050 -C mychannel -n mycc -v 1.0 -c '{"Args":["org.hyperledger.fabric.contract:init","mypackage.MyChaincodeClass"]}'

关键说明 #

• ContractRouter是Fabric Java链码2.x版本的标准启动类，负责加载合约类、处理链码与Peer节点的通信。
• ServicesResourceTransformer用于合并所有依赖Jar包中的META-INF/services配置文件，确保框架能通过SPI机制找到你的合约实现类，这一步不可省略。

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