Playwright.NET 在 IIS 环境下运行异常问题深度解析

问题现象

当开发者在 Windows Server 2022 的 IIS 环境中部署基于 .NET Framework 4.8 的 ASP.NET 应用时，调用 Playwright.CreateAsync() 方法会抛出"Process exited"异常。值得注意的是，同样的代码在 .NET Core 测试应用中运行正常，这表明问题与环境配置密切相关。

根本原因分析

经过技术团队深入排查，发现该问题主要涉及以下几个技术层面：

1. 进程执行权限问题：

   • IIS 应用池默认配置限制了子进程的执行权限
   • Playwright 需要启动 Node.js 子进程来驱动浏览器操作

2. 文件系统权限：

   • 虽然已检查基础权限，但可能遗漏了临时目录或特定子目录的权限设置
   • Playwright 需要访问其安装目录下的二进制文件（位于 bin/.playwright）

3. 环境隔离：

   • IIS 环境与普通控制台应用的环境变量存在差异
   • 可能缺少必要的 PATH 环境变量或系统依赖

解决方案

方案一：调整应用池配置

1. 为应用池创建专用服务账户
2. 授予该账户以下权限：
   • 执行批处理脚本的权限
   • 对临时目录的读写权限
   • 对 Playwright 安装目录的完全控制权限

方案二：手动验证执行环境

1. 定位到项目目录下的 bin/.playwright 文件夹
2. 尝试手动执行其中的 node.exe 程序
3. 检查是否能够正常启动并运行简单脚本

方案三：部署时注意事项

1. 确保发布过程包含所有 Playwright 运行时文件
2. 验证目标服务器上是否存在完整的 .playwright 目录结构
3. 考虑使用 dotnet publish 命令的 --runtime 参数指定目标环境

最佳实践建议

对于需要在传统 IIS 环境中使用 Playwright.NET 的情况，建议：

1. 建立专用的中间层服务处理浏览器自动化任务
2. 考虑使用 Windows 服务而非 IIS 托管关键自动化功能
3. 实施完善的日志记录机制，捕获进程启动阶段的详细错误信息
4. 定期验证环境依赖，特别是当服务器进行安全更新后

技术深度解读

Playwright 在 .NET 环境中的工作流程实际上是通过进程间通信实现的。主进程（您的应用）会启动一个 Node.js 子进程，两者通过管道进行通信。在 IIS 这种受限制的环境中，这种跨进程通信模式特别容易受到安全策略的影响。理解这一架构特点有助于更好地排查类似问题。

对于企业级应用，建议考虑将这些自动化任务移至后台服务或独立的微服务中处理，既可以避免 IIS 的环境限制，又能提高系统的可靠性和可维护性。