1. 环境准备从零搭建FISCO BCOS开发基础第一次接触联盟链开发时最让人头疼的就是环境配置。我刚开始用FISCO BCOS时光是依赖项安装就折腾了半天。不过别担心跟着我的步骤走保证你能避开那些坑。操作系统选择方面官方推荐Ubuntu 18.04或20.04 LTS版本。我实测过CentOS也能跑但有些依赖包需要手动解决对新手不太友好。建议直接上Ubuntu省时省力。准备一台至少4核CPU、8GB内存的机器虚拟机也行硬盘空间留个50GB比较稳妥。安装依赖其实就两行命令但很多人会漏装curlsudo apt update sudo apt install -y openssl curl这里有个细节要注意如果系统提示Unable to locate package先运行sudo apt update更新软件源列表。我之前在阿里云服务器上就遇到过这问题卡了半小时才发现是镜像源没同步。工作目录建议放在用户主目录下这样权限管理简单mkdir -p ~/fisco cd ~/fisco别学有些教程把目录建在/opt下到时候权限问题能让你怀疑人生。我见过新手因为sudo权限问题重装系统的血泪教训啊。2. 快速搭建单机多节点联盟链2.1 一键构建区块链网络FISCO BCOS最方便的就是这个build_chain.sh脚本它能自动完成所有节点配置。下载时记得检查版本号现在最新稳定版是2.9.0curl -#LO https://github.com/FISCO-BCOS/FISCO-BCOS/releases/download/v2.9.0/build_chain.sh chmod x build_chain.sh如果下载速度慢可以换成国内镜像curl -#LO https://gitee.com/FISCO-BCOS/FISCO-BCOS/raw/master/tools/build_chain.sh启动单机4节点网络适合开发测试bash build_chain.sh -l 127.0.0.1:4 -p 30300,20200,8545这里的端口参数很关键30300是P2P端口20200是RPC端口8545是Channel端口我建议显式指定端口范围避免随机分配导致端口冲突。曾经有个项目因为端口被占用了查了整整一天...2.2 节点启动与状态检查启动所有节点cd ~/fisco/nodes/127.0.0.1 bash start_all.sh检查节点是否正常运行的三个方法查看进程ps -ef | grep fisco-bcos | grep -v grep应该能看到4个节点进程检查日志共识状态tail -f node0/log/log* | grep 正常情况会持续输出表示共识正常检查节点连接数tail -f node0/log/log* | grep connected每个节点应该显示连接数3其他3个节点如果遇到节点启动失败90%的问题都是端口冲突。用这个命令找出占用进程sudo lsof -i:端口号3. 控制台配置与使用技巧3.1 Java环境配置控制台需要Java环境这里有个坑Java 8和Java 11的表现不一样。推荐用OpenJDK 11sudo apt install -y openjdk-11-jdk验证安装java -version应该显示类似OpenJDK 11.0.xx的信息3.2 控制台下载与配置下载控制台cd ~/fisco curl -LO https://github.com/FISCO-BCOS/console/releases/download/v2.9.0/download_console.sh bash download_console.sh证书配置是关键步骤cp console/conf/config-example.toml console/conf/config.toml cp -r nodes/127.0.0.1/sdk/* console/conf/这里经常出的问题是证书权限不对记得检查ls -l console/conf/*.crt所有证书应该是-rw-r--r--权限3.3 控制台高级用法启动控制台cd ~/fisco/console bash start.sh几个实用命令# 查看群组列表 getGroupList # 查看节点版本 getNodeVersion # 查看区块高度 getBlockNumber # 查看节点连接信息 getPeers有个特别实用的技巧按Tab键可以自动补全命令。我刚开始不知道这个功能每次都手动输入完整命令手指都快抽筋了。4. 智能合约开发全流程实战4.1 HelloWorld合约深度解析别看HelloWorld简单它包含了智能合约的所有核心要素。我们来看这个增强版pragma solidity ^0.4.25; contract HelloWorld { string private name; uint256 public callCount; constructor() public { name Hello, FISCO BCOS; callCount 0; } function get() public view returns (string memory) { return name; } function set(string memory _name) public { name _name; callCount 1; } function getCallCount() public view returns (uint256) { return callCount; } }这个版本增加了调用次数统计更接近真实业务场景。注意几个关键点状态变量要用private保护公开变量会自动生成getter方法记得标记view/pure修饰符4.2 合约部署与交互实战部署合约控制台内deploy HelloWorld记下返回的合约地址比如0x123...abc调用合约方法# 读取数据不消耗gas call HelloWorld 0x123...abc get # 写入数据需要共识 call HelloWorld 0x123...abc set New Name # 查看调用次数 call HelloWorld 0x123...abc getCallCount性能调优小技巧如果发现交易执行慢可以调整config.toml中的gasLimit参数。我做过测试适当提高gasLimit能让交易确认速度提升30%以上。4.3 常见问题排查部署失败检查合约是否在contracts/solidity目录下确认solidity版本匹配控制台默认0.4.25调用返回空值确认合约地址正确检查方法是否标记为view/pure交易长时间不确认检查节点共识状态查看日志是否有错误我遇到最诡异的一个bug是合约部署成功但调用无效最后发现是控制台缓存问题。解决方法很简单退出控制台重新进入就行。