如何让IPFS add操作的await生效？解决ipfs.add异步流程不等待的问题

你遇到的await失效、哈希为undefined的问题，本质是对ipfs.add的异步返回逻辑理解错了：

• 老版本ipfs-api的add方法同时支持「回调风格」和「Promise风格」两种调用形式，只要你给方法传入了回调参数，它就会走旧的回调执行逻辑，返回的Promise根本不会等待回调函数执行完成
• await只能等待Promise的状态变更，没法感知回调里的执行流程，所以代码会直接跳过ipfs.add的回调逻辑往下走，等回调真正执行、给映射表赋值的时候，程序已经走到了输出内容的步骤，最终拿到的映射自然是空的，哈希值也因为还没拿到返回结果显示为undefined

只需要调整两处核心逻辑，就能让await正常阻塞等待上传完成：

1. 调用ipfs.add时不要传入回调函数，直接等待方法原生返回的Promise结果，让await能正确感知异步流程的完成时机
2. 把文件读取、遍历的流程改成完整的async/await结构，等所有文件都上传完成、映射表填充完毕后，再触发JSON文件写入

调整后的可运行代码 #

const IPFS = require('ipfs-api');
const ipfs = new IPFS({ host: 'ipfs.infura.io', port: 5001, protocol: 'https' });
const fs = require('fs-extra'); 

const dir = 'D:/JTEST/';
let nameToHash = new Object();

function writeJSON() {
    let output = JSON.stringify(nameToHash, null, 2);
    fs.writeFileSync('output.json', output);
}

async function addFile(data, filename){
    try {
        // 不传回调，直接等待Promise返回结果
        const uploadResult = await ipfs.add(data);
        const fileHash = uploadResult[0].hash;
        console.log(`文件${filename}上传完成，哈希：${fileHash}`);
        nameToHash[filename] = fileHash;
        return fileHash;
    } catch (err) {
        console.error(`文件${filename}上传失败：`, err);
        nameToHash[filename] = `上传失败：${err.message}`;
    }
}

// 主流程函数
async function main() {
    const files = await fs.readdir(dir);
    for (const file of files) {
        const fullPath = `${dir}${file}`;
        // 跳过目录，只处理普通文件
        const fileStat = await fs.stat(fullPath);
        if (fileStat.isDirectory()) continue;
        
        const data = fs.readFileSync(fullPath);
        await addFile(data, file);
        console.log('当前映射表状态：', nameToHash);
    }
    // 所有文件处理完成后再写入JSON
    writeJSON();
    console.log('所有文件处理完成，output.json已生成');
}

// 启动主流程，捕获全局异常
main().catch(err => console.error('程序运行异常：', err));

• 不要再给ipfs.add同时传回调和写await逻辑，这种混用方式会直接破坏Promise的封装链路，是这类异步失效问题的最高发原因
• 原来的ipfs-api包已经停止维护，如果是新写的项目可以替换为官方的ipfs-http-client包，核心API逻辑完全兼容
• 上传过程中如果遇到Infura节点的限流问题，可以适当给每个文件的上传加简单的重试逻辑，避免单个文件失败影响整体流程

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