IRONSOFTWAREHOME

在Linux和WSL上未使用许可证密钥时的Win32Exception

Curtis Chau
Curtis Chau
Updated: 2026年6月10日

在Ubuntu、WSL或Docker容器中运行IronPDF而没有许可证密钥时,应用程序会抛出一个引用xdg-open的异常。

System.ComponentModel.Win32Exception: An error occurred trying to start process 'xdg-open' with working directory '/path/to/your/project/bin/Debug/net7.0'. No such file or directory
Text

发生此错误必须同时满足三个条件:运行在Linux或WSL上、未配置IronPDF许可证密钥且xdg-open未安装。 没有许可证密钥,IronPDF会尝试使用xdg-open打开浏览器以显示试用通知。 该工具在精简的Linux环境中缺失,导致Win32Exception。

解决方案

步骤1:设置许可证密钥

在任何PDF渲染调用之前配置许可证密钥:

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

试用密钥也能解决该问题。 设置有效的许可证密钥可以防止IronPDF尝试打开浏览器。

步骤2:安装xdg-utils

如果您需要在没有许可证密钥的情况下运行或想消除依赖:

sudo apt update
sudo apt install xdg-utils
SHELL

有关完整的Linux和WSL设置,请参阅Linux部署指南

Curtis Chau
技术作家

Curtis Chau 拥有卡尔顿大学的计算机科学学士学位,专注于前端开发,精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面,喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。

...
阅读更多

准备开始了吗?

Nuget Downloads 20,878,335版本:2026.9刚刚发布

立即获取您的免费30 天试用密钥
无需信用卡或创建账户
C# 用于 PDF 的 NuGet 库
通过 NuGet 安装

版本: 2026.9

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. 在解决方案资源管理器中,右键点击引用,管理 NuGet 包
  2. 选择浏览并搜索 “IronPDF”
  3. 选择包并安装
C# PDF DLL
下载 DLL

版本: 2026.9

或在此处下载 Windows 安装程序。

  1. 下载并解压 IronPDF 到您的解决方案目录中的 ~/Libs 之类的位置
  2. 在 Visual Studio 解决方案资源管理器中,右键点击引用。选择浏览,“IronPDF.dll”

$999

Key in blue circle

立即获取免费的 30 天试用版密钥

Your trial license will be sent to your email address

无任何限制。100% 解锁。无需信用卡。

bullet_checked无需信用卡或创建账户无任何限制。100% 解锁。无需信用卡。
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
预约您的免费现场演示
Booking Badge

深受全球数百万工程师信赖

Iron Software 的客户徽标
获取您的无义务咨询
填写下面的表格或通过sales@ironsoftware.com
您的资料将始终保密。
深受全球数百万工程师信赖
Iron Software 的客户徽标
立即获取您的免费30 天试用密钥
无需信用卡或创建账户