dfx deploy --network ic部署失败求助：重复资产路径问题

开发者阿泽

2026-7-30

解决Internet Canister部署时资产重复冲突问题

排查与解决步骤：

检查dfx.json资产配置
打开项目根目录的dfx.json，找到对应资产canister的配置段，确认source字段是否同时包含了源码资产目录和构建输出目录。比如如果同时写了src/dbank_assets/assets和dist/dbank_assets，会导致重复扫描，只保留构建后的dist路径即可：
```
"dbank_assets": {
  "type": "assets",
  "source": ["dist/dbank_assets"],
  "destination": "assets"
}
```
彻底清理缓存与构建产物
除了删除dist，还要清理dfx的本地缓存和临时文件：
```
dfx cache clean
rm -rf .dfx dist
```
之后重新构建并部署：
```
npm run build
dfx deploy --network ic
```
验证webpack构建配置
确认webpack的output路径没有和源码资产目录重叠，避免构建产物写入到dfx会扫描的源码路径中。同时确保即使注释了CopyPlugin，构建过程不会自动复制重复的资产文件。
清理冗余依赖与重新安装
如果之前的CopyPlugin配置残留影响构建，执行以下命令重置依赖：
```
rm -rf node_modules package-lock.json
npm install
```
重新构建后再尝试部署。
手动移除重复源文件
如果src/dbank_assets/assets/main.css是不需要的冗余文件，直接删除该文件，从根源避免重复资产的存在。