简介这份资源是面向计算机相关专业在校学生与教师的区块链数据共享系统完整项目包可作为毕业设计、课程设计或大作业的参考实现。项目基于以太坊构建通过智能合约实现访问控制涵盖前端页面、后端逻辑与链上合约的协同开发适合具备一定Web与区块链基础、希望深入理解去中心化数据共享机制的学习者。压缩包共27个文件约352KB包含9个JavaScript脚本负责前后端交互与合约调用7个HTML页面承载登录、注册、数据上传与详情展示等界面另有Solidity智能合约、CSS样式表及说明文档结构紧凑、模块清晰。目前已有35人学习关注。读者可从中获取一套可运行的访问控制合约示例、完整的前后端调用链路以及数据共享场景下的权限管理思路便于在此基础上修改扩展用于答辩演示或二次开发。1. 从一份毕业设计说起区块链数据共享系统到底在解决什么如果你正在做区块链方向的毕业设计或课程设计大概率会遇到这个选题基于以太坊实现一个数据共享系统带前后端和智能合约核心功能是访问控制。听起来像是把「区块链」「数据共享」「智能合约」「访问控制」四个热词拼在一起但真正动手时你会发现难点不在于写一个能跑的合约而在于想清楚数据到底存不存链上、访问权限怎么用合约表达、前端怎么和合约交互、后端还剩下什么活。这套系统的本质是用智能合约作为权限仲裁者把「谁能在什么条件下访问哪份数据」的规则写成链上逻辑数据本身加密后存在链下链上只记录权限映射和访问日志。它适合毕业设计答辩时展示完整闭环也适合课设用来理解以太坊合约开发、前后端联调和访问控制模型。接下来我会按实际搭建顺序把每个环节拆开讲清楚。2. 架构选型链上存什么、链下存什么、后端管什么2.1 为什么不能把所有数据都塞进合约很多新手第一反应是把文件内容直接写进智能合约的 storage。这样做在本地测试链上能跑通但一旦部署到测试网就会翻车以太坊存储成本极高存 1KB 数据的手续费可能比服务器一个月租金还贵。更关键的是链上数据默认公开你把用户数据写进去等于全网广播。常见做法是链上只存三样东西数据哈希用于完整性校验、访问控制列表谁有权限、访问记录谁在什么时候请求过。真正的数据文件加密后存 IPFS 或传统数据库链上合约只负责「发钥匙」和「记日志」。这样既利用了区块链不可篡改的特性又避开了存储成本和隐私问题。2.2 访问控制模型ACL 还是基于角色热搜词里有人搜「华为 acl 单向和双向访问控制区别」虽然那是网络设备层面的 ACL但思路可以借鉴单向控制只管「谁能进」双向控制还要管「谁能出」。在区块链数据共享场景里我一般用基于角色的访问控制RBAC变体角色权限链上表现数据拥有者上传、授权、撤销合约中记录 owner 地址普通用户请求访问、查看已授权数据映射表 mapping(address bool)管理员审核、冻结异常账户多签或单独 admin 地址合约里用mapping(bytes32 mapping(address uint8))来存「数据ID → 用户地址 → 权限等级」0 表示无权限1 表示只读2 表示可下载。这样比单纯布尔值更灵活答辩时也能体现设计深度。2.3 前后端分工后端不是多余的有人会问既然合约管权限前端直接连钱包不就行了要后端干嘛实际落地时后端至少承担三个职责第一缓存链上事件日志因为前端直接查合约事件效率低且容易超时第二代理 IPFS 上传下载避免前端暴露存储密钥第三做链下身份和链上地址的映射比如学号对应钱包地址的绑定关系。我一般用 Node.js Express 做后端前端用 React 或 Vue通过 ethers.js 与合约交互。后端不碰私钥所有签名操作由用户在前端钱包完成这样责任边界清晰答辩时也经得起追问。3. 智能合约编写访问控制的核心逻辑与部署步骤3.1 合约结构设计三个关键映射先看合约骨架。下面是一个最小可用的访问控制合约包含数据注册、权限授予、权限校验三个核心功能// SPDX-License-Identifier: MIT pragma solidity ^0.8.0; contract DataSharing { // 数据ID 拥有者地址 mapping(bytes32 address) public dataOwner; // 数据ID 用户地址 权限等级(0无,1只读,2下载) mapping(bytes32 mapping(address uint8)) public permissions; // 数据ID 数据哈希(链下存储的完整性校验) mapping(bytes32 string) public dataHash; event DataRegistered(bytes32 indexed dataId, address owner); event AccessGranted(bytes32 indexed dataId, address user, uint8 level); event AccessRevoked(bytes32 indexed dataId, address user); // 注册数据调用者成为拥有者 function registerData(bytes32 dataId, string memory hash) external { require(dataOwner[dataId] address(0), Data already exists); dataOwner[dataId] msg.sender; dataHash[dataId] hash; emit DataRegistered(dataId, msg.sender); } // 只有拥有者可以授权 function grantAccess(bytes32 dataId, address user, uint8 level) external { require(dataOwner[dataId] msg.sender, Not the owner); require(level 1 level 2, Invalid level); permissions[dataId][user] level; emit AccessGranted(dataId, user, level); } // 撤销权限 function revokeAccess(bytes32 dataId, address user) external { require(dataOwner[dataId] msg.sender, Not the owner); permissions[dataId][user] 0; emit AccessRevoked(dataId, user); } // 校验权限供前端或后端调用 function checkAccess(bytes32 dataId, address user) external view returns (uint8) { return permissions[dataId][user]; } }逻辑说明registerData用require防止重复注册dataOwner映射记录归属。grantAccess里msg.sender必须是数据拥有者这是访问控制的第一道闸。checkAccess是 view 函数不消耗 gas前端可以频繁调用。参数说明dataId建议用keccak256(abi.encodePacked(文件名, 拥有者地址, 时间戳))生成保证唯一性。level用 1 和 2 区分只读和下载比布尔值更细。hash存 IPFS 的 CID 或文件 SHA256用于下载后校验。3.2 用 Hardhat 本地部署与测试合约写完后用 Hardhat 在本地跑通。先初始化项目mkdir blockchain-data-sharing cd blockchain-data-sharing npm init -y npm install --save-dev hardhat nomicfoundation/hardhat-toolbox npx hardhat init选择「Create a JavaScript project」然后把上面的合约放到contracts/DataSharing.sol。接着写部署脚本scripts/deploy.jsconst hre require(hardhat); async function main() { const DataSharing await hre.ethers.getContractFactory(DataSharing); const contract await DataSharing.deploy(); await contract.waitForDeployment(); console.log(DataSharing deployed to:, await contract.getAddress()); } main().catch((error) { console.error(error); process.exitCode 1; });运行npx hardhat run scripts/deploy.js你会看到本地测试链上部署成功的地址。这一步是后续前后端联调的基础地址要记下来填到前端配置里。3.3 测试用例覆盖授权与撤销写一个测试脚本验证权限逻辑避免上线后才发现漏洞const { expect } require(chai); const { ethers } require(hardhat); describe(DataSharing, function () { let contract, owner, user1; beforeEach(async function () { [owner, user1] await ethers.getSigners(); const DataSharing await ethers.getContractFactory(DataSharing); contract await DataSharing.deploy(); }); it(should grant and revoke access correctly, async function () { const dataId ethers.keccak256(ethers.toUtf8Bytes(test-data)); await contract.registerData(dataId, QmTestHash); await contract.grantAccess(dataId, user1.address, 1); expect(await contract.checkAccess(dataId, user1.address)).to.equal(1); await contract.revokeAccess(dataId, user1.address); expect(await contract.checkAccess(dataId, user1.address)).to.equal(0); }); });运行npx hardhat test全绿说明合约逻辑没问题。注意测试里用了ethers.keccak256生成 dataId和前端保持一致否则会出现「链上查不到」的玄学问题。4. 前后端联调从钱包连接到数据下载的完整链路4.1 前端连接 MetaMask 与合约实例化前端第一步是让用户连接钱包拿到地址后再实例化合约。用 ethers.js v6 的写法import { BrowserProvider, Contract } from ethers; const CONTRACT_ADDRESS 0xYourDeployedAddress; const ABI [/* 合约编译后的 ABI */]; async function connectWallet() { if (!window.ethereum) throw new Error(请安装 MetaMask); const provider new BrowserProvider(window.ethereum); await provider.send(eth_requestAccounts, []); const signer await provider.getSigner(); const contract new Contract(CONTRACT_ADDRESS, ABI, signer); return { provider, signer, contract }; }逻辑说明BrowserProvider包装了 MetaMask 注入的window.ethereumgetSigner()拿到当前账户的签名器后续所有写操作都用这个 signer。读操作可以用 provider 直接调省去签名步骤。参数说明CONTRACT_ADDRESS填部署脚本输出的地址ABI从artifacts/contracts/DataSharing.sol/DataSharing.json里复制。注意 ABI 要完整缺一个函数就会报「method not found」。4.2 后端缓存事件日志与 IPFS 代理后端用 Express 起一个服务监听合约事件并存入本地数据库前端查权限时先查缓存减少链上调用const express require(express); const { ethers } require(ethers); const app express(); const provider new ethers.JsonRpcProvider(http://127.0.0.1:8545); const contract new ethers.Contract(CONTRACT_ADDRESS, ABI, provider); // 监听授权事件写入内存或数据库 contract.on(AccessGranted, (dataId, user, level) { console.log(Granted: ${dataId} to ${user} level ${level}); // 这里可以写入 sqlite 或 redis }); app.get(/api/access/:dataId/:user, async (req, res) { const level await contract.checkAccess(req.params.dataId, req.params.user); res.json({ level: Number(level) }); }); app.listen(3001, () console.log(Backend running on 3001));逻辑说明contract.on是事件订阅链上每次授权都会触发回调后端把结果缓存下来。/api/access接口代理了checkAccess调用前端不用直接连链也能查权限。参数说明JsonRpcProvider的地址填本地 Hardhat 节点或测试网 RPC。生产环境要把事件写入持久化存储否则重启后缓存丢失。4.3 数据上传下载加密与哈希校验数据文件不能明文存 IPFS我一般在前端用 AES 加密后再上传密钥通过合约授权时传递。下载时先查权限等级再从 IPFS 拉取密文用本地密钥解密最后比对链上哈希import CryptoJS from crypto-js; // 加密上传 function encryptFile(fileBuffer, secretKey) { const wordArray CryptoJS.lib.WordArray.create(fileBuffer); const encrypted CryptoJS.AES.encrypt(wordArray, secretKey).toString(); return encrypted; } // 下载后校验 async function downloadAndVerify(dataId, secretKey) { const hashOnChain await contract.dataHash(dataId); const encrypted await fetchFromIPFS(dataId); const decrypted CryptoJS.AES.decrypt(encrypted, secretKey); const fileBuffer decrypted.toString(CryptoJS.enc.Base64); const localHash CryptoJS.SHA256(fileBuffer).toString(); if (localHash ! hashOnChain) throw new Error(数据被篡改); return fileBuffer; }逻辑说明加密用 AES 对称加密密钥不落链通过安全通道传给被授权用户。哈希校验确保 IPFS 上的文件没被替换这是区块链「不可篡改」承诺的最后一环。参数说明secretKey建议用 ECDH 协商生成不要硬编码。fetchFromIPFS可以用公共网关或自建节点毕业设计里用公共网关够用。5. 避坑与排查那些答辩前夜才发现的翻车现场5.1 合约部署后前端报「contract not deployed」现象前端调用合约方法时抛出contract not deployed或call revert exception。原因通常是 ABI 和地址不匹配或者 Hardhat 节点重启后合约状态丢失。解决每次重启本地链后重新部署把新地址更新到前端配置ABI 从编译产物重新复制不要手写。5.2 MetaMask 链 ID 与本地节点不一致现象钱包显示已连接但交易一直 pending 或报chainId mismatch。原因是 MetaMask 默认连主网而 Hardhat 本地链的 chainId 是 31337。解决在 MetaMask 里手动添加本地网络RPC 填http://127.0.0.1:8545chainId 填 31337然后切换过去。5.3 事件监听重复触发导致数据重复现象后端日志里同一条授权记录出现多次。原因是contract.on在组件重新渲染或服务重启时被多次注册。解决用contract.off先移除旧监听或者把监听逻辑放在服务启动时只执行一次不要放在请求处理函数里。5.4 gas 估算失败导致交易发不出去现象调用grantAccess时 MetaMask 提示gas estimation failed。常见原因是require条件不满足比如调用者不是数据拥有者。解决先在测试里用staticCall模拟执行确认msg.sender和dataOwner一致如果是权限问题检查前端传的 signer 是不是当前账户。5.5 IPFS 网关超时导致下载卡死现象前端请求 IPFS 文件时长时间无响应。公共网关在国内访问不稳定这是血泪经验。解决后端自建 IPFS 节点做代理或者把加密后的文件同时存一份到传统对象存储作为兜底IPFS 只存哈希做校验。6. 进阶技巧用链下签名做免 gas 授权与批量验证合约授权每次都要发交易用户要付 gas体验很差。一个实用进阶方案是链下签名授权数据拥有者用私钥对「dataId user level nonce」签名被授权用户拿着签名去调用合约合约用ecrecover验证签名来源通过后直接写入权限映射。这样拥有者不用发交易只有被授权者付一次 gas。function grantAccessBySig( bytes32 dataId, address user, uint8 level, uint256 nonce, bytes memory signature ) external { bytes32 message keccak256(abi.encodePacked(dataId, user, level, nonce)); bytes32 ethSigned keccak256(abi.encodePacked(\x19Ethereum Signed Message:\n32, message)); address signer recoverSigner(ethSigned, signature); require(signer dataOwner[dataId], Invalid signature); require(nonce nonces[signer], Bad nonce); permissions[dataId][user] level; emit AccessGranted(dataId, user, level); }逻辑说明recoverSigner内部用ecrecover从签名反推地址和dataOwner比对。nonce防止重放攻击每次签名后递增。前端用signer.signMessage生成签名后端或用户自己提交交易。参数说明nonce存在合约里mapping(address uint256) public nonces签名前先查当前值。signature是 65 字节的 rsv 拼接ethers.js 的signMessage直接产出这个格式。验证方法写一个测试用例用 owner 签名后由 user1 提交交易检查checkAccess返回正确等级再用同样的签名提交第二次应该因为 nonce 不匹配而失败。这样既验证了功能也验证了安全性。我自己的习惯是每加一个链下签名功能必写三个测试——正常流程、重放攻击、错误签名。毕业设计答辩时老师最爱问「如果别人伪造签名怎么办」这三个测试就是最好的回答。希望帮到你。本文还有配套的精品资源点击获取