如何在.NET Web应用中用C#编写读取EPUB文件的Reading API？

我之前在.NET Web项目里也折腾过EPUB处理的事儿，太懂你这种找不到合适文档的头疼了！结合实操经验，给你整理一套可行的方案：

第一步：把Base64字符串还原为可处理的流 #

首先得把前端传过来的Base64字符串转换成.NET能识别的流，这是后续处理的基础。这里要注意处理Base64可能带的前缀（比如data:application/epub+zip;base64,）：

public IActionResult ProcessEpub([FromBody] EpubRequest request)
{
    // 移除Base64前缀（如果存在）
    var cleanBase64 = request.Base64String.StartsWith("data:") 
        ? request.Base64String.Split(',').Last() 
        : request.Base64String;
    
    try
    {
        // 转换为字节数组并生成内存流
        byte[] epubBytes = Convert.FromBase64String(cleanBase64);
        using var epubStream = new MemoryStream(epubBytes);
        
        // 后续EPUB库处理逻辑写在这里
        // ...
        return Ok(new { Message = "EPUB处理成功" });
    }
    catch (FormatException)
    {
        return BadRequest("无效的Base64格式字符串");
    }
}

// 接收请求的模型类
public class EpubRequest
{
    public string Base64String { get; set; }
}

第二步：选择适合Web场景的EPUB库 #

我实测过两个靠谱的.NET库，给你附上简化使用代码，解决文档不全的问题：

1. EpubSharp（轻量高效，适合基础读取） #

这个库体积小，Web场景下性能友好，虽然文档少但核心功能够用：

// 通过NuGet安装：Install-Package EpubSharp
using EpubSharp;

// 在流处理代码中添加：
var epubBook = EpubReader.Read(epubStream);

// 获取书籍元数据
var bookTitle = epubBook.Title;
var bookAuthor = epubBook.Author;

// 遍历读取章节内容
foreach (var chapter in epubBook.Chapters)
{
    string chapterHtml = chapter.Content; // 章节的HTML原始内容
    // 可根据需求转换为纯文本或直接返回给前端
}

2. EpubReader（功能全面，支持高级操作） #

如果需要处理复杂EPUB（比如带目录、自定义样式的），这个库更合适，文档相对完善：

// 通过NuGet安装：Install-Package EpubReader
using EpubReader;

// 在流处理代码中添加：
var book = EpubReader.ReadBook(epubStream);

// 获取元数据详情
var metadata = book.Metadata;
string subtitle = metadata.Subtitle ?? "无副标题";
List<string> authors = metadata.Creators.ToList();

// 按阅读顺序读取所有章节内容
var chapterContents = book.ReadingOrder
    .Select(item => book.Content.GetXhtmlContent(item.Href))
    .ToList();

第三步：Web应用专属注意事项 #

• 内存管控：处理大EPUB文件时，务必用using包裹流对象，避免内存泄漏。
• 参数校验：除了Base64格式验证，还可以添加文件大小限制，防止超大请求拖垮服务。
• 响应优化：如果不需要返回全量内容，可以只提取元数据或指定章节，减少响应体积。

常见问题排查 #

• 若库读取流报错，优先检查Base64转换后的字节数组是否完整，有没有残留前缀。
• 大部分开源库不支持DRM加密的EPUB，要提前告知前端不要传输加密文件。

内容的提问来源于stack exchange，提问作者Adaji Ojonimi Daniel