如何查看Kubernetes(DinD)部署的Fabric2.2.2 Java链码日志并排查查询500错误

一、定位链码Pod与获取日志 #

1. K8s集群内直接查找链码Pod #

链码Pod命名通常遵循 dev-<通道名>-<链码名>-<版本>-<随机后缀> 规则，可通过以下命令快速定位：

# 按链码名过滤
kubectl get pods -n <你的命名空间> | grep <链码名称>

# 按链码标签过滤（部分部署会给链码Pod打app=chaincode标签）
kubectl get pods -n <你的命名空间> -l app=chaincode

2. 进入Peer Pod查看DinD内的链码容器 #

由于采用Docker-in-Docker模式，链码容器运行在Peer Pod内部的Docker环境中，需进入Peer Pod操作：

# 进入目标Peer Pod
kubectl exec -it <peer-pod-name> -n <命名空间> -- bash

# 列出Peer内部的所有Docker容器，找到链码容器
docker ps | grep <链码名称>

# 查看链码容器日志
docker logs <链码容器ID>

3. 查看Bevel部署的链码配置 #

通过Bevel部署的链码，可检查Peer的环境变量或Fabric配置文件，确认链码的启动模式与容器管理参数：

# 查看Peer Pod的环境变量
kubectl exec <peer-pod-name> -n <命名空间> -- env | grep CHAINCODE

二、500错误排查方向 #

1. 链码查询逻辑代码问题 #

• 未捕获异常：Java链码中若存在未处理的RuntimeException，会直接导致Fabric返回500错误，且不会在Peer日志中输出详细信息。需在查询方法中添加异常捕获逻辑，返回明确错误信息，同时添加日志记录关键步骤与参数。
• 参数或空指针问题：对比invoke与query的参数格式，检查是否存在参数类型不匹配、空值未处理的情况；确认查询的状态键（包括复合键）构造是否正确。
• 状态数据库操作错误：查询需使用getState/getStateByRange等读操作，若误用putState等写操作，会触发模拟交易失败；同时检查是否访问了不存在的状态键且未做判空处理。

2. Peer节点查询相关配置 #

• 背书策略验证：虽然invoke正常，但需确认查询的背书策略是否与invoke一致，是否存在部分Peer节点未正确启动链码的情况：

  # 查看链码的背书策略
  peer chaincode inspect -C <通道名> -n <链码名>
  

• 状态数据库同步检查：验证接收查询请求的Peer节点状态数据库（如CouchDB）是否已同步最新数据，可直接查询CouchDB确认目标状态是否存在。

3. DinD环境特殊问题 #

• 容器权限与网络：检查链码容器是否有足够权限访问Peer资源，以及DinD内部容器与Peer的网络连通性（可在Peer Pod内ping链码容器IP测试）。
• 资源限制：查看链码Pod的资源使用情况，确认是否因内存/CPU不足导致查询时容器崩溃：

  kubectl describe pod <链码Pod名> -n <命名空间>
  

4. 增强日志排查 #

• 提升Peer日志级别：修改Peer部署的FABRIC_LOGGING_SPEC环境变量为DEBUG，重启Peer后重新执行查询，获取更详细的交易模拟日志：

  kubectl edit deployment <peer-deployment-name> -n <命名空间>
  # 修改后查看实时日志
  kubectl logs <peer-pod-name> -n <命名空间> -f
  

• 链码内部日志：在Java链码中添加SLF4J日志，记录查询参数、执行流程与中间结果，重新打包安装链码后查看链码日志。

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