GraphQL服务端如何正确实现多文件而非单文件上传
GraphQL多图片上传实现修正
现有代码的报错触发点
- Resolver层逻辑硬伤
- 鉴权执行后直接打印
file变量,但代码中从未定义该变量,第一行业务逻辑就触发ReferenceError - 循环内调用
createReadStream()未绑定实际文件对象:graphql-upload提供的Upload实例自带createReadStream方法,空调用无法获取文件读流 - 存储路径变量错配:自行拼接的本地路径
pathname没有被写入逻辑引用,反而读取files[i].pathname属性,但Upload对象不存在该属性,直接触发写入路径不存在错误 - 流异步处理错误:
stream.pipe()返回可写流实例而非Promise,直接await无法等待文件写入完成,会导致多图场景下文件内容截断 - 查询定义不合法
- 前端上传查询未指定返回字段:GraphQL协议要求查询必须明确声明要返回的字段,当前查询只写了
uploadImage(files: $files),未指定要返回的path字段,会直接触发schema校验报错 - 基础配置遗漏
- 需确认服务端已全局注册
Upload标量,且挂载了graphql-upload处理中间件,中间件的maxFiles参数未限制为1
修正后的各环节代码
服务端Resolver
export const uploadImage = async (_, { files }, context) => { await jwtAuthentication.verifyTokenMiddleware(context); try { const fileArr = []; // 提前创建存储目录,避免路径不存在报错 await fs.promises.mkdir(path.join(__dirname, '/public/images'), { recursive: true }); for (const uploadFile of files) { // 从Upload实例获取文件读流 const fileReadStream = uploadFile.createReadStream(); // 拼接本地存储路径 const savePath = path.join(__dirname, `/public/images/${uploadFile.filename}`); // 用Promise封装流写入完成事件,保证异步顺序 await new Promise((resolve, reject) => { const writeStream = fs.createWriteStream(savePath); fileReadStream.pipe(writeStream); writeStream.on('finish', resolve); writeStream.on('error', reject); }); // 拼接可访问的文件URL fileArr.push({ path: `${apiUrl}/images/${uploadFile.filename}` }); } return fileArr; } catch (error) { console.log('上传异常', error); throw new Error('图片上传失败'); } };
核心修正:删除未定义的日志逻辑、正确绑定文件读流、用Promise封装流写入过程、提前初始化存储目录
Schema定义
原有的类型定义逻辑符合多图上传要求,仅需补充全局Upload标量注册:
scalar Upload type ImageUploadResult { path: String } extend type Mutation { uploadImage(files: [Upload]): [ImageUploadResult] }
前端上传查询
补充返回字段声明,增加非空约束提升校验效率:
export const UPLOAD_IMAGE = gql` mutation($files: [Upload!]!) { uploadImage(files: $files) { path } } `;
前端触发函数
仅需确保传入的files是从文件input控件获取的FileList转换后的数组即可:
const uploadFiles = async (): Promise<void> => { try { const response = await GraphqlRequest(auth.token).request(UPLOAD_IMAGE, { files }); console.log('上传结果', response.uploadImage); } catch (err) { console.log('上传报错', err); } };
内容的提问来源于stack exchange,提问作者Sotiris Kourouklis
相关产品推荐
相关产品推荐

