本文介绍了一个基于 ASP.NET Core 和 Python 实现的 PDF 转 Word 工具的开发与部署经验。主要解决了 IIS 部署中 Python 路径配置、支付回调逻辑、文件上传大小限制及服务生命周期冲突等技术问题。技术栈涵盖 ASP.NET Core 8、Entity Framework Core、SQL Server 及 Python 3.12。文章提供了详细的配置文件设置、权限分配脚本及开发建议，适用于希望构建类似文档处理服务的开发者参考。
在文档处理场景中，常遇到 PDF 无法直接编辑、内容修改导致重排耗时、表格复制错位等问题。本文介绍了一个基于 ASP.NET Core 和 Python 实现的 PDF 转 Word 工具的开发与部署经验。
使用配置文件 (
appsettings.json) 或环境变量指定 Python.exe 路径，确保应用池有执行权限
修正 AccountId 与订单流水号的对应关系。在 Controller 内使用
IServiceScopeFactory.CreateScope()创建服务范围，确保生命周期正确
修改 Kestrel 配置：
options.Limits.MaxRequestBodySize = 104857600修改 FormOptions：options.MultipartBodyLengthLimit = 104857600
IServiceScopeFactory.CreateScope() 在后台任务中创建服务实例，使用 using 创建临时作用域| 技术 | 用途 | 说明 |
|---|---|---|
| ASP.NET Core 8 | Web API 框架 | 提供控制器、路由、JWT 授权、文件上传接口 |
| Entity Framework Core | 数据访问 | 与 SQL Server 对接，实现账户、文件映射、充值记录 CRUD |
| SQL Server | 数据库 | 存储账户、文件映射、充值记录、日志 |
| IOptionsMonitor / Configuration | 配置管理 | 管理 Python 路径、支付配置、速率限制等 |
| 技术 | 用途 | 说明 |
|---|---|---|
| JWT (JSON Web Token) | 用户认证 | 保护上传/下载接口，确保每个请求有用户身份 |
| Authorization Attributes | 权限控制 | [Authorize] 控制 API 权限 |
| Rate Limiting Middleware | 频率控制 | 限制请求频率，保护接口安全 |
| 技术 | 用途 | 说明 |
|---|---|---|
| Python 3.12及相关的库：pdf2docx | PDF → Word 转换 | 使用自定义脚本 pdf_to_word.py 处理文件转换 |
| ConcurrentQueue + SemaphoreSlim | 队列处理 | 实现后台单任务队列，避免多用户同时处理冲突 |
| IWebHostEnvironment | 文件路径管理 | 管理上传目录 /uploads 和静态文件访问 |
| 技术 | 用途 | 说明 |
|---|---|---|
| 易支付（YiPay） | 支付通道 | 接收用户支付，支持异步通知 |
| TopUpService / Strategy 模式 | 充值管理 | 控制用户使用次数、减少重复逻辑 |
| 日志文件 | 调试与监控 | logs/debug.log 记录支付和文件操作状态 |
| 技术 | 用途 | 说明 |
|---|---|---|
| Visual Studio 2022 / VS Code | 开发 | 后端开发、调试、迁移数据库 |
| IIS / 云服务器 | 部署 | 托管 ASP.NET Core + Python 环境 |
| Swagger | API 文档 | 方便测试上传、下载接口和 JWT 调用 |
| 技术 | 用途 | 说明 |
|---|---|---|
| FileCleanupService / RateLimitCleanupService | 后台服务 | 清理过期文件和过期速率限制记录 |
| RequestDurationMiddleware | 性能监控 | 记录每次请求耗时，便于优化 |
pdf_to_word.py 文件到项目目录。YiPayConfig：对接易支付平台Jwt：生成不低于 32 位的 keyPythonConfig：注意本地环境和服务器环境 python 解释器的位置MailSendServiceConfig：申请 SMTP 服务假设 Python 安装路径：
C:\Users\Administrator\AppData\Local\Programs\Python\Python312
在 PowerShell（以管理员身份）执行：
$pythonPath = "C:\Users\Administrator\AppData\Local\Programs\Python\Python312"
$acl = Get-Acl $pythonPath
$permission = "IIS AppPool\<应用池名称>","ReadAndExecute","ContainerInherit,ObjectInherit","None","Allow"
$rule = New-Object System.Security.AccessControl.FileSystemAccessRule $permission
$acl.AddAccessRule($rule)
Set-Acl $pythonPath $acl
这会给 IIS 应用池身份用户读取和执行 Python 的权限。
假设 uploads 文件夹在：
C:\inetpub\PDFtoWord\uploads
同样用 PowerShell 给应用池写入权限：
$uploadsPath = "C:\inetpub\PDFtoWord\uploads"
$acl = Get-Acl $uploadsPath
$permission = "IIS AppPool\<应用池名称>","Modify","ContainerInherit,ObjectInherit","None","Allow"
$rule = New-Object System.Security.AccessControl.FileSystemAccessRule $permission
$acl.AddAccessRule($rule)
Set-Acl $uploadsPath $acl
注意：如果 uploads 文件夹不存在，需要先手动创建。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online