Oracle Cloud Infrastructure 上 Oracle Blockchain Platform 的已知问题

了解您在使用 Oracle Blockchain Platform 时可能遇到的问题以及如何解决这些问题。

主题：

以前发行版中最初报告的问题：

不支持存储和 OCPU 缩放

Oracle Blockchain Platform 版本 25.4.1 实例不支持扩展存储或 OCPU 容量。如果您尝试使用 REST API 缩放存储或 OCPU 容量，则会返回 UnsupportedOperationException 错误消息。

Hyperledger Fabric SDK 已不赞成使用

现在，Hyperledger Fabric SDK 已过时，不再支持 Fabric Gateway 客户端 API。仍可以使用超级账本架构 SDK 为 Oracle Blockchain Platform 开发应用，但最好使用 Fabric Gateway 客户端 API。

REST API 中报告的存储值不正确

对于 Oracle Blockchain Platform 版本 25.4.1 实例，Get Blockchain Platform Information REST API 端点返回的 storageUsedInTBs 值始终为 0。

解决方法：此问题没有解决方法。

验证块 REST API 未返回某些字段

Oracle Blockchain Platform 版本 25.4.1 实例上的验证块 REST API 端点不会返回以下字段：verifyResult 和 firstBlockNum。

解决方法：此问题没有解决方法。

无法查看渠道的分类账详细信息

在渠道的分类账页面上单击块时，将显示事务处理详细信息。存在间歇性问题，在您单击块时，有时不会显示事务处理详细信息。

解决方法：刷新浏览器页面，然后再次单击该块以显示事务处理详细信息。

丰富历史记录配置未保存

单击配置富历史记录对话框中的保存时，UI 指示全局配置已成功保存；但是，当您尝试查看富历史记录配置时，它不可用，因为它未实际保存。这是一个间歇性问题。

解决方法：重试保存丰富的历史记录配置。

Go Chaincode 版本兼容性

对于 Oracle Blockchain Platform 版本 25.4.1，使用的 Go 版本已更新为 1.24.4。如果您尝试部署或升级与 Go 1.24.4 不兼容的链代码，该过程可能会失败。在升级或部署以 Go 编写的链代码之前，请确保链代码可以使用 Go 1.24.4 构建。您可以对安装了 Go 1.24.4 的系统上的 chaincode 文件夹的内容使用以下命令来检查错误：
go mod tidy
go mod vendor

当前部署的链代码不受此行为的影响，并且将在升级到 Oracle Blockchain Platform 25.4.1 后继续按预期工作。

Node.js 链码版本兼容性

对于 Oracle Blockchain Platform 版本 25.4.1，使用的 Node.js 版本已更新为 22.14.0。如果尝试部署或升级与 Node.js 22.14.0 不兼容的链代码，该过程可能会失败。在升级或部署以 Node.js 编写的链代码之前，请确保链代码可以使用 Node.js 22.14.0 进行构建。

当前部署的链代码不受此行为的影响，并且将在升级到 Oracle Blockchain Platform 25.4.1 后继续按预期工作。

铸造和刻录审批后未更改的暂挂余额

铸造和燃烧审批使用暂挂机制，该机制将操作 ID 作为输入。方法 getOnHoldBalanceWithOperationId 和 getOnHoldDetailsWithOperationId 返回与指定的操作 ID 关联的暂挂金额。对于使用 executeHold 和 releaseHold 方法的标准暂挂操作，暂挂金额在方法完成后会更改。例如，如果请求 100 个令牌的操作 ID 为 first 的暂挂，则在审批（使用 executeHold 方法）后，暂挂金额为 0。getOnHoldBalanceWithOperationId 和 getOnHoldDetailsWithOperationId 方法将返回 0 作为操作 ID first 的暂挂金额。

此行为不适用于铸造或刻录审批。例如，如果请求使用操作 ID second 生成 100 个令牌，则在批准（使用 approveMint 方法）后，暂挂金额仍为 100。对于操作 ID second，getOnHoldBalanceWithOperationId 和 getOnHoldDetailsWithOperationId 方法将返回 100。

在铸造或燃烧的情况下，批准代表铸造或烧毁该数量的请求，但在批准阶段不会发生转移。由于铸造和刻录审批使用与标准暂挂操作相同的内部暂挂机制，因此查询方法返回存储在暂挂键 - 值对中的值，这些值在铸造或刻录审批之后不会更改。

解决方法：您可以使用 getOnHoldBalanceWithOperationId 和 getOnHoldDetailsWithOperationId 方法验证请求的薄荷或消耗量，但要注意这些操作与标准暂挂操作之间的差异。

以前发行版中最初报告的问题：

升级 Go 链代码时出现账户限制错误

如果您使用扩展的令牌分类框架标准将以前版本的区块链应用程序构建器以 Go 语言生成的链代码升级到版本 25.2.2，则在尝试完成事务处理时可能会看到以下错误：
account has exceeded the limit for maximum number of transfers -1
特定于批发 CBDC 模型的链代码的 Go 版本也会出现此错误。出现此错误的原因是，上一版本的 Blockchain App Builder 使用值 -1 表示没有每日帐户限制，但在版本 25.2.2 中没有默认值，并且缺少该键/值对表示帐户没有每日限制。
解决方法：使用以下方法为账户限制设置新的默认值。如果不传递可选 max_daily_amount 或 max_daily_transaction 参数的任何值，则会删除键/值对，以便帐户在版本 25.2.2 中正常工作。 
SetMaxDailyAmount(token_id string, org_id string, user_id string, max_daily_amount ...float64)
SetMaxDailyTransactionCount(token_id string, org_id string, user_id string, max_daily_transactions ...float64)

在 Microsoft Windows 11 上调试时出现意外的标记错误

在 Microsoft Windows 11 上运行的 Visual Studio Code 中使用 Blockchain App Builder 调试函数时，将显示以下错误消息： 
Unexpected token ':"admin"' in expression or statement.
出现此错误时，链代码部署和调试失败。

解决方法：此问题没有解决方法。

无每日账户限额的必需 Go 语法

在使用扩展令牌分类框架标准和 Go 编程语言的区块链应用程序构建器生成的链代码中，如果您不想在使用 CreateAccount 方法时设置每日账户限制，则必须传递空值 "" 而不是 "{}" 作为 daily_limits 参数。CreateAccount 方法的 Go 版本的正确参数类似于以下示例： 
["CentralBank","cb","fungible",""]
特定于批发 CBDC 模型的链代码的此 Go 版本也有此要求。

使用 Postman 集合时出现 REST 代理超时错误

对于 Blockchain App Builder 生成的 Postman 集合（使用 Oracle Blockchain Platform REST 代理运行事务处理），默认超时值设置为 6000，如以下示例所示：
{
    "chaincode": "WholesaleCBDCConfidential",
    "args": [
        "getTokenAuditors"
    ],
    "timeout": 6000,
    "sync": true,
    "peer": "org-xyz-abc.blockchain.ocp.oraclecloud.com:20009",
    "transientMap": {
        "args": "[]"
    }
    }'
在某些情况下，即使 Oracle Blockchain Platform 实际正在处理事务处理，REST 代理处理也会超时，这将导致以下响应：
{
    "returnCode": "Failure",
    "error": "failed to invoke chaincode: Client Status Code: (5) TIMEOUT. Description: request timed out or been cancelled",
    "result": null
}

解决方法：根据您的特定用例增加超时值。

Visual Studio Code 中的函数列表包含两种方法不正确

将机密事务处理功能与 Visual Studio Code 版本的区块链应用程序构建器结合使用时，执行窗格的函数列表中显示了两种方法：executeHoldTokensSender 和 executeHoldTokensReceiver。仅当与 REST 代理的双阶段提交 API（Blockchain App Builder 的 Visual Studio Code 版本不支持）一起使用时，这两种方法才能正常工作。请勿在 Blockchain App Builder 的 Visual Studio Code 版本中使用这两种方法。

如果先决条件检查失败，将卸载应用程序构建器 CLI

通过安装或重新安装最新版本升级 Blockchain App Builder 命令行界面 (command-line interface，CLI) 时，如果先决条件检查失败，将卸载现有的 Blockchain App Builder CLI。

解决方法：您可以重新安装旧版本的 Blockchain App Builder CLI，或者更新系统以满足先决条件，然后安装较新版本的 Blockchain App Builder CLI。

小数 NFT 事务处理使用不正确的小数位数时无错误

使用区块链应用程序构建器处理使用 ERC-1155 标准的小数 NFT 时，如果事务处理金额使用的小数位数大于规范文件中的最大小数位数，则不会指明错误。相反，实际事务处理金额将被截断为规范文件中定义的小数位数。此外，即使发送者和接收者的余额被截断到指定的位数，事务处理历史记录中的 transactedAmount 值也会显示未截断的值。

解决方法：在创建事务处理之前验证事务处理金额，以确保事务处理金额使用的小数位数不会超过在链代码的输入规范文件中指定的小数位数。

无法从开发人员工具页运行法定货币令牌或余额转移样品

Oracle Blockchain Platform 22.4.2 中包含了新版本的 Fiat Money Token 示例。更新的链代码的软件包 ID 与以前版本不同。如果部署了 Fiat Money Token 示例，则在升级到 Oracle Blockchain Platform 22.4.2 后，该示例将不再显示在控制台的“Developer Tools（开发人员工具）”页面上，并且您将无法从“Developer Tools（开发人员工具）”页面中运行该示例的任何操作。

针对 Oracle Blockchain Platform 22.3.2 更新了余额转移示例，以使用原子事务功能，也会出现相同的行为。

解决方法：在对等端上再次安装样例链代码，这将使用新的软件包 ID 安装较新版本的链代码。对于部署了样例的每个通道，将链代码升级到新软件包。升级链代码后，示例在“Developer Tools（开发人员工具）”页面上的状态和操作将正常运行。

使用区块链应用程序构建器时出现部署错误

使用区块链应用程序构建器部署 Go 链代码项目时，您可能会遇到类似以下错误：
ERROR RunCommand: spawn modd ENOENT
ERROR RunCommand: Error in Chaincode deployment
[+] Running 3/3
  Container ca.example.com Stopped 0.4s
  Container orderer.example.com Stopped 0.6s
  Container peer0.org1.example.com Stopped 0.6s
ERROR RunCommand: Error in Chaincode deployment, process exit with code 1
解决方法：
macOS
  1. 运行以下命令： 
    env GO111MODULE=off go get ‘github.com/cortesi/modd/cmd/modd’
  2. 重试部署。
Microsoft Windows
  1. 使用 go install 运行以下命令：
    go install github.com/cortesi/modd/cmd/modd@latest
  2. 使用 go get 运行以下命令：
    SET GO111MODULE=auto
go get ‘github.com/cortesi/modd/cmd/modd’
  3. 重试部署。

区块链应用程序构建器生成的 TypeScript 链代码中的初始化失败

如果使用 Blockchain App Builder 版本 22.4.2 或更早版本生成 TypeScript 链代码，则在本地或远程部署或运行链代码时，可能会看到类似以下文本的错误：
本地环境：
INFO: Error in initalizing chaincode. Error :  failed to initialize chaincode Error: Failed to 
initialize the chaincode Error: endorsement failure during invoke. response: status:500 message:"error 
in simulation: failed to execute transaction 
e22ba18c00ecbd3135cdb509e08667cf6d5d9e79c4217b73492b5bb50836d58d: could not launch chaincode 
testagain:v0: error building chaincode: error building image: failed to get chaincode package for 
external build: could not get legacy chaincode package 'testagain:v0': open 
/var/hyperledger/production/chaincodes/testagain.v0: no such file or directory
远程环境：
INFO: 

============ Started Initializing Chaincode ============

ERROR: {
  "Error": "Chaincode Deployment failed. Error in initializing chaincode: Status Code: 400, 
Error Message: {\"returnCode\":\"Failure\",\"error\":\"failed to invoke chaincode: 
Transaction processing for endorser 
[jasfounderdec5-oabcs1-ams.blockchain.ocp.oraclecloud.com:20010]: Chaincode status Code: 
(500) UNKNOWN. Description: error in simulation: failed to execute transaction 
947bbaf2feccc39cdf53bd7a07cd17f15d682a5a4ee6e3c3e63dec6346b0394e: error sending: chaincode 
stream terminated\",\"result\":null}"
}

解决方法：要解决现有链代码的此行为，请完成以下支持页面中的步骤：

本地和远程 OBP 环境中的 TypeScript 链代码部署失败

为了避免在新的链代码中出现这种行为，请升级到 Blockchain App Builder 22.4.3 或更高版本。您可以从 Oracle Blockchain Platform 控制台的“Blockchain App Builder”窗格上的开发人员工具选项卡下载区块链应用构建器。

使用 XA 库时的网关超时

将 XA Java 库与 Oracle Blockchain Platform 结合使用时，可以将多个区块链事务处理组合成一个由外部事务处理管理器控制的全局事务处理。如果区块链事务处理的完成时间超过网关超时值 60 秒，则事务处理状态可能会在事务处理管理器端和 Oracle Blockchain Platform 端变得不确定。

解决方法：此问题没有解决方法。在这种情况下，必须手动解析事务处理。

无法在 Microsoft Windows 的调试模式下运行标记链代码

如果您使用 Blockchain App Builder 版本 22.2.1 或更早版本，则无法在 Microsoft Windows 上以调试模式运行令牌链代码。

解决方法：升级到最新版本的区块链应用构建器。如果您无法升级，请完成以下步骤：

  1. 打开 chaincode/.vscode/task.json 文件进行编辑。
  2. task.json 文件的第六行包含 command 密钥。从行中删除以下字符串： 
    -p '${workspaceFolder}'
例如，编辑前 task.json 文件中的行：
"command": "ochain debug -p '${workspaceFolder}' \"[{\\\"userId\\\":\\\"admin\\\",\\\"orgId\\\":\\\"Org1MSP\\\"}]\" -v v8",
之后：
"command": "ochain debug \"[{\\\"userId\\\":\\\"admin\\\",\\\"orgId\\\":\\\"Org1MSP\\\"}]\" -v v8",

事件大小限制

从版本 22.2.1 开始，默认情况下，事件的最大有效负载大小限制为 50 KB。将删除大于最大有效负载大小的任何事件。Oracle DevOps 团队可以请求修改此参数。如果您希望订阅有效负载将大于 50 KB 的事件，请在 My Oracle Support 中创建一个服务请求 (Service Request，SR)，以请求更大的最大事件大小。有关详细信息，请参阅 REST API 文档中的订阅事件。

包含冒号 (：) 的用户 ID 不能用于 REST API 调用

Oracle Blockchain Platform 允许您将包含冒号 (：) 的用户 ID 与 REST 代理注册关联。但是，当使用基本验证（用户名和密码）时，该用户 ID 不能用于 REST API 调用。

解决方法：确保与 REST 代理注册关联的所有用户的用户 ID 中没有冒号 (：)。

由于凭据无效，未返回 CORS 标头

如果请求中发送的凭证无效、不正确或已过期，则调用 REST 代理事务处理的客户应用程序将不会在响应中收到跨源资源共享 (CORS) 标头（ Access-Control-Allow-Origin 标头）。

创建渠道时出现排序者状态错误

创建通道时，可能会看到以下错误：
Failed to create the channel with error: aborted
Please check the orderers status.

解决方法：再次尝试创建通道。这是一个间歇性问题。

在 Microsoft Windows 上的 Visual Studio Code 中调试

在 Microsoft Windows 上，在 Visual Studio Code 中调试链代码项目时，可能会遇到如下错误：
dlv: failed to install dlv(github.com/go-delve/delve/cmd/dlv@latest): Error: Command failed:
C:\Program Files (x86)\Go\bin\go.exe get -x github.com/go-delve/delve/cmd/dlv@latest
# get https://proxy.golang.org/github.com/go-delve/delve/cmd/dlv/@v/list
# get https://proxy.golang.org/github.com/@v/list
# get https://proxy.golang.org/github.com/go-delve/@v/list
# get https://proxy.golang.org/github.com/go-delve/delve/cmd/@v/list
# get https://proxy.golang.org/github.com/go-delve/delve/@v/list
# get https://proxy.golang.org/github.com/@v/list: 410 Gone (0.420s)
# get https://proxy.golang.org/github.com/go-delve/delve/cmd/@v/list: 410 Gone (1.040s)
# get https://proxy.golang.org/github.com/go-delve/@v/list: 410 Gone (1.062s)
# get https://proxy.golang.org/github.com/go-delve/delve/cmd/dlv/@v/list: 410 Gone (1.066s)
# get https://proxy.golang.org/github.com/go-delve/delve/@v/list: 200 OK (1.448s)
go: found github.com/go-delve/delve/cmd/dlv in github.com/go-delve/delve v1.8.3C:\Users\<UserName>\go\pkg\mod\github.com\go-delve\delve@v1.8.3\service\debugger\debugger.go:28:2:found packages native (proc.go) and 
your_operating_system_and_architecture_combination_is_not_supported_by_delve(support_sentinel.go) in C:\Users\Asus\go\pkg\mod\github.com\go-delve\delve@v1.8.3\pkg\proc\native
此时没有此错误的解决方法。

多组织环境和区块链应用构建器

在具有多个组织的环境中，您可能需要使用控制台来完成某些操作。

要通过参与者实例在同一渠道中重新部署链代码，请使用控制台部署链代码。

(Hyperledger Fabric v2.2.4) 要升级链代码，请使用控制台并从参与者手动批准链代码。

缩放一次仅适用于一个组件

一次只能缩放一个节点类型。例如，您可以同时添加对等节点和修改现有的对等节点设置，但如果您还想增加存储，则必须单独这样做。

此外，您一次只能缩放一个对等节点或 OSN - 例如，您无法在单个操作中添加两个对等节点。

操作系统时钟不正确可能导致被拒绝的请求

如果客户端或 SDK 的本地时钟休息超过 15 分钟，则来自客户端或 SDK 的请求将被对等节点和排序节点拒绝。确保本地时钟设置正确。

旧客户端 SDK 导致区块链应用无法按预期工作

如果应用程序使用较旧版本的客户端 SDK，则其行为可能会出乎意料。

解决方法：阅读描述客户端 SDK 更新并根据需要修改应用程序的文档。有关更多信息，请参见超级账本架构文档中的超级账本架构 SDK 。

该网络的 Oracle Blockchain Platform 实例无法管理撤销的第三方证书

如果 Oracle Blockchain Platform 网络包含具有第三方证书的组织或 Hyperledger Fabric 组织，且其证书已撤销，则已撤销的证书不会应用于网络 Oracle Blockchain Platform 实例，也不会显示，也不会从该实例中撤消。

解决方法：使用本机 Hyperledger Fabric CLI 或 SDK 导入组织的证书撤销列表 (Certificate Revocation List，CRL) 文件。

创始人的渠道列表包含由信息创建的错误，并且“编辑渠道组织”选项不可用

在混合网络（创始人实例和参与者实例运行不同版本的 Oracle Blockchain Platform ）中，创始人的渠道列表可能会显示参与者创建的渠道的错误 MSP ID。将显示创始人的 MSP ID，而不是参与者的 MSP ID。在导入 CRL、撤消或应用 CRL 或在通道上设置锚点对等点后，可能会发生这种情况。

渠道的编辑渠道组织选项仅适用于创建者字段中显示的实例。如果显示错误的 MSP ID，则渠道创建者无法更新渠道组织。

解决方法：此问题没有解决方法。

Oracle Blockchain Platform 不支持 ImplicitMeta 策略

如果使用本机 Hyperledger Fabric CLI 或 SDK 修改通道的配置，则 Oracle Blockchain Platform 不支持您指定的某些配置设置。

  • 本机超级账本架构 CLI 和 SDK 对读者和写入者使用 ImplicitMeta 通道策略。当通道使用这些策略时，Oracle Blockchain Platform 控制台无法保证可以成功处理管理操作（例如编辑组织）。

    解决方法：将读取者和写入者策略更新为签名策略，并根据需要定义策略规则。有关更多信息，请参见 Hyperledger Fabric 文档中的 Access Control Lists (ACL) 。

  • 如果通道使用 ImplicitMeta 策略类型，并且在通道配置中，您将“组”部分中的 mod_policy 更改为“管理员”，并且通道中存在多个组织，则无法使用 Oracle Blockchain Platform 管理通道。例如，您无法向渠道添加新组织，也无法以任何方式更改渠道的 ACL 策略，包括恢复其原始值。

    解决方法：使用本机 Hyperledger Fabric CLI 或 SDK 管理通道。

渠道创建者无法更新渠道的配置

使用本机 Hyperledger Fabric CLI 或 SDK 创建通道时，configtx.yaml 文件中不包含 Creator 策略。Oracle Blockchain Platform 要求创建者策略允许渠道创建者编辑渠道的配置。

解决方法：手动编辑 configtx.yaml 文件以添加创建者策略。

在 REST API 中将 instantiateChaincode 端点中的 blocktolive 设置为 0

如果您使用的是 REST API 的 instantiateChaincode 端点，并且在 dataCollectionConfig 中将 blocktolive 值设置为 0，则会收到以下错误： {"respMesg"："invalid argument"} 。

为了防止从专用数据库清除数据，Hyperledger Fabric 要求您将 blocktolive 值设置为 0。但是，Oracle Blockchain Platform REST API 不支持将此配置设置为 0。

解决方法：使用控制台实例化链代码，然后在 Instantiate Chaincode 对话框的 "Private Data Collections"（专用数据集合）部分中，将 blocktolive 字段设置为 0。

对等端无法从另一个对等端提取专用数据

如果专用数据收集的 blocktolive 值小于 10 且其 maxPeerCount 值小于对等方总数（不包括背书对等方），则对等方可能无法从另一个对等方提取专用数据。此值是在您使用控制台创建专用数据收集定义或使用本机超级账本架构 CLI 或 SDK 时设置的。

解决方法：确认 blocktolive 值设置为大于或等于 10。或者，确认 maxPeerCount 值设置为不小于对等方总数，不包括背书对等方。如果需要，您可以重新实例化或升级链代码以重置这些值。

渠道创建者组织和渠道策略设置不一致

您可以使用控制台创建通道并将组织的 ACL 设置为 ReaderOnly。保存新渠道后，无法从渠道的编辑渠道组织选项更新此 ACL 设置。

但是，您可以使用控制台的管理通道策略选项将组织添加到写入器策略，该策略将覆盖通道的 ReaderOnly ACL 设置。

解决方法：此问题没有解决方法。

导出和导入的文件不兼容性

无法在控制台与 REST API 之间导出和导入文件（CRL、证书、取消删除服务设置以及对等节点）。

控制台和 REST API 导出的文件仅与具有相同组件的导入兼容。例如，如果使用控制台导出对等端，则无法使用 REST API 导入对等端（只能使用控制台导入）。如果您使用 REST API 导出对等节点，则无法通过控制台导入该对等节点（只能使用 REST API 导入）。

解决方法：此问题没有解决方法。

链码名称要求

Oracle Blockchain Platform 链代码名称和版本要求与超级账本架构要求不同。从控制台或超级账本架构客户端部署链代码时，必须满足 Oracle Blockchain Platform 的要求。如果您在从超级账本架构客户端进行部署时未遵循这些要求，则链代码可能会在控制台中错误地列出。

解决方法：在部署链代码名称和版本时使用以下规则。

  • 使用 ASCII 字母数字字符、短划线 (-) 和下划线 (_)。
  • 名称只能以 ASCII 字母数字字符开头和结尾。例如，您不能使用 _mychaincode 或 mychaincode_ 等名称。
  • 短划线 (-) 和下划线 (_) 后面必须跟有 ASCII 字母数字字符。例如，您不能使用 my--chaincode 或 my-_chaincode 等名称。
  • 名称和版本长度最多可为 64 个字符。
  • 链代码版本还可以包含句点 (.) 和加号 (+)。

日期和时间选择器行为

Oracle Blockchain Platform 日期和时间选择器的行为不符合预期。您可以使用日期和时间选择器来筛选日志文件或分类账活动等项目。

解决方法：使用以下信息帮助您使用日期和时间选择器。

  • 如果选择特定时间段（例如，最后一天），然后再次选择该时间段以重新运行查询，则不会重新运行查询。要获取最新信息，请单击“刷新”按钮。
  • 如果尚未在计算机上设置时区，则在选择定制选项时，必须以 GMT 格式指定开始时间和结束时间。但是，如果在“首选项”中将“时区设置”设置为 GMT （在控制台中，选择实例名称，然后单击“首选项”，然后单击“时区设置”），则控制台上的时区将自动转换为 GMT。