---
title: "Reentrancy"
type: concept
tags: [smart-contract, vulnerability, defi, solidity, security]
sources: [blockchain-security-auditor]
last_updated: 2026-04-25
---

## 中文定义

**重入攻击（Reentrancy）**：智能合约在执行外部调用后、在状态更新前，允许攻击者通过回调函数再次进入合约逻辑，从而在状态被正确更新前回滚执行、重复提取资金或操纵合约状态的漏洞类型。

## 问题描述

当合约 A 调用合约 B 的函数时，合约 B 可以在其 `receive()`/`fallback()` 函数中回调合约 A 的函数。如果合约 A 在外部调用之前读取了状态（如用户余额），但在该调用返回后才更新状态（清零余额），攻击者合约 B 可以在余额清零前回拨合约 A 的函数，再次触发提取逻辑。

## 攻击模式

### 1. 单函数重入（Single-Function Reentrancy）
最简单的模式：同一个函数在执行中被再次调用。The DAO 和 Curve Finance 属于此类。

### 2. 跨函数重入（Cross-Function Reentrancy）
攻击者通过不同的函数路径重入合约，利用状态不一致进行攻击。例如：`withdraw()` 读取的余额与 `transfer()` 检查的余额不同步。

### 3. 只读重入（Read-Only Reentrancy）
攻击者通过 `view` 函数读取合约状态（在外部调用期间），利用该状态作为预言机输入进行攻击，无需写入合约。

### 4. ERC-777 / ERC-1155 钩子重入
即使合约没有 `receive()` 函数，使用 ERC-777 代币标准时，`transfer()` 会触发 `tokensReceived()` 钩子，攻击者可在钩子中重入。

## 防御机制

### Checks-Effects-Interactions Pattern
```solidity
// ✅ 正确顺序：先更新状态，再执行外部调用
function withdraw() external {
    uint256 amount = balances[msg.sender];
    require(amount > 0);
    balances[msg.sender] = 0;          // 先更新状态
    (bool success,) = msg.sender.call{value: amount}(""); // 后外部调用
    require(success);
}
```

### Reentrancy Guard
```solidity
import {ReentrancyGuard} from "@openzeppelin/contracts/utils/ReentrancyGuard.sol";

contract SecureVault is ReentrancyGuard {
    function withdraw() external nonReentrant {
        // nonReentrant 修饰符防止任何重入
    }
}
```

## 关键案例
- [[The-DAO-2016]]：历史上首个大规模重入攻击，损失 360 万 ETH，直接导致 ETH/ETC 硬分叉
- [[Curve-Finance]]：Vyper 编译器 bug 导致 nonreentrant 失效，损失超 7000 万美元
- [[blockchain-security-auditor]] 的 Source Page 示例代码：展示了完整的有漏洞合约和修复后合约

## 关联概念
- [[Access-Control]]：权限控制缺失会加剧重入攻击的影响
- [[Flash-Loan-Attack]]：重入攻击常与闪电贷结合使用
- Checks-Effects-Interactions Pattern：标准防御模式
- [[Slither]]：Slither 的 `reentrancy-eth` 检测器可发现大多数经典重入漏洞