Corda测试网部署CorDapp异常：合约Jar未加载请求报错排查

开发者阿泽

2026-5-13

排查Corda生产模式下合约CorDapp未加载问题

针对你遇到的合约CorDapp未加载、仅工作流Jar被加载的问题，结合生产模式的特性，我整理了几个关键排查步骤：

1. 先确认合约Jar的基础状态

检查合约Jar的完整性：用命令 jar tf <你的合约Jar文件名> 查看Jar内的内容，确认包含Contract和State相关的.class文件（比如com/example/contracts/YourContract.class），如果缺失，说明构建过程有问题，需要重新编译合约模块。
核对Jar的存放路径：确保合约Jar确实放到了节点的cordapps根目录下，不要放到cordapps的子目录（比如workflows文件夹），节点只会扫描根目录下的CorDapp Jar。

这大概率是核心问题：Corda生产模式（devMode = false）下，节点会拒绝加载未签名的CorDapp。你在合约模块build.gradle里设置signing.enabled = false，生成的是未签名Jar，生产模式下节点会直接跳过加载这类Jar。

解决办法：

临时测试验证：修改节点配置文件node.conf，将devMode改为true，重启节点后查看日志，如果合约Jar能正常加载，就说明是签名问题导致的。（注意：这个方法只适合测试，生产环境不能开启devMode）
生产环境正确做法：为合约CorDapp配置签名。你需要生成签名密钥库，在build.gradle里配置签名参数，示例如下：
```
cordapp {
    signing {
        enabled = true
        keyStorePath = "path/to/your/keystore.jks"
        keyStorePassword = "your-keystore-password"
        keyAlias = "your-key-alias"
        keyPassword = "your-key-password"
    }
}
```
重新构建合约模块，生成签名后的Jar，再放到节点cordapps目录下重启节点。

仔细查看节点启动时的日志，搜索包含CorDapp的条目：

如果看到类似Unsigned CorDapp not allowed in production mode的提示，直接坐实签名问题。
如果日志里根本没出现扫描到合约Jar的记录，说明Jar路径不对或者文件名不符合Corda的CorDapp命名规范（一般建议包含cordapp关键字，便于节点识别）。

确保工作流模块的build.gradle正确依赖了合约模块，避免Flow执行时找不到合约类：

dependencies {
    cordapp project(':contracts')
}

不过注意，即使依赖正确，合约Jar还是需要单独部署到节点的cordapps目录，工作流Jar不会自动包含合约类。

解决完上述问题后，重启节点，应该就能看到合约CorDapp被正常加载，POST请求的报错也会随之消失。

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