- 创建统一的下载错误处理模块 (lib/download-errors.ts) - 实现13种错误类型分类和中文错误消息 - 后端统一使用 createDownloadError 创建标准化错误响应 - 前端统一使用 parseDownloadError 解析错误并显示 - 修复正式系统数据库Schema,添加产品全案相关字段和表 - 执行数据库迁移:添加 task_no, task_status, task_fetched_at 字段 - 创建 material_assets, api_keys, api_call_logs 表
136 lines
3.3 KiB
TypeScript
136 lines
3.3 KiB
TypeScript
/**
|
||
* 统一的文件清理工具函数
|
||
* 用于统一处理 S3 文件和本地文件/目录的删除逻辑
|
||
*/
|
||
|
||
import { deleteFromS3, isS3Url } from './s3';
|
||
import { promises as fs } from 'fs';
|
||
import path from 'path';
|
||
|
||
export interface DeleteFileResult {
|
||
success: boolean;
|
||
isDirectory?: boolean;
|
||
error?: string;
|
||
}
|
||
|
||
/**
|
||
* 删除单个文件或目录(统一入口)
|
||
* @param fileUrl 文件 URL(S3 URL 或本地路径)
|
||
* @param basePath 可选,本地文件的基础路径(用于相对路径)
|
||
* @returns 删除结果
|
||
*/
|
||
export async function deleteFile(
|
||
fileUrl: string,
|
||
basePath?: string
|
||
): Promise<DeleteFileResult> {
|
||
if (!fileUrl || !fileUrl.trim()) {
|
||
return { success: false, error: '文件路径为空' };
|
||
}
|
||
|
||
try {
|
||
if (isS3Url(fileUrl)) {
|
||
// S3 文件
|
||
await deleteFromS3(fileUrl);
|
||
return { success: true };
|
||
} else {
|
||
// 本地文件或目录
|
||
return await deleteLocalFile(fileUrl, basePath);
|
||
}
|
||
} catch (error: any) {
|
||
return {
|
||
success: false,
|
||
error: error.message || '删除失败',
|
||
};
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 删除本地文件或目录
|
||
* @param filePath 文件路径(绝对路径或相对路径)
|
||
* @param basePath 可选,基础路径(用于相对路径)
|
||
* @returns 删除结果
|
||
*/
|
||
export async function deleteLocalFile(
|
||
filePath: string,
|
||
basePath?: string
|
||
): Promise<DeleteFileResult> {
|
||
try {
|
||
// 处理路径
|
||
let absolutePath: string;
|
||
if (path.isAbsolute(filePath)) {
|
||
absolutePath = filePath;
|
||
} else if (filePath.startsWith('/')) {
|
||
absolutePath = filePath;
|
||
} else {
|
||
absolutePath = path.join(basePath || process.cwd(), filePath);
|
||
}
|
||
|
||
// 检查文件/目录是否存在
|
||
let stats;
|
||
try {
|
||
stats = await fs.stat(absolutePath);
|
||
} catch (err: any) {
|
||
if (err.code === 'ENOENT') {
|
||
// 文件/目录不存在,不算错误
|
||
return { success: true };
|
||
}
|
||
throw err;
|
||
}
|
||
|
||
// 根据类型删除
|
||
if (stats.isDirectory()) {
|
||
// 目录:递归删除
|
||
await fs.rm(absolutePath, { recursive: true, force: true });
|
||
return { success: true, isDirectory: true };
|
||
} else {
|
||
// 文件:直接删除
|
||
await fs.unlink(absolutePath);
|
||
return { success: true, isDirectory: false };
|
||
}
|
||
} catch (error: any) {
|
||
if (error.code === 'ENOENT') {
|
||
// 文件/目录不存在,不算错误
|
||
return { success: true };
|
||
}
|
||
return {
|
||
success: false,
|
||
error: error.message || '删除失败',
|
||
};
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 批量删除文件
|
||
* @param fileUrls 文件 URL 列表
|
||
* @param basePath 可选,本地文件的基础路径
|
||
* @returns 删除统计
|
||
*/
|
||
export async function deleteFiles(
|
||
fileUrls: string[],
|
||
basePath?: string
|
||
): Promise<{
|
||
deletedCount: number;
|
||
failedCount: number;
|
||
errors: Array<{ fileUrl: string; error: string }>;
|
||
}> {
|
||
const uniqueFiles = Array.from(new Set(fileUrls.filter(f => f && f.trim())));
|
||
let deletedCount = 0;
|
||
let failedCount = 0;
|
||
const errors: Array<{ fileUrl: string; error: string }> = [];
|
||
|
||
for (const fileUrl of uniqueFiles) {
|
||
const result = await deleteFile(fileUrl, basePath);
|
||
if (result.success) {
|
||
deletedCount++;
|
||
} else {
|
||
failedCount++;
|
||
errors.push({
|
||
fileUrl,
|
||
error: result.error || '删除失败',
|
||
});
|
||
}
|
||
}
|
||
|
||
return { deletedCount, failedCount, errors };
|
||
}
|