1. IronPDF
  2. Solución de Problemas
  3. System.Environment.FailFast with ReadyToRun

System.Environment.FailFast with ReadyToRun

Curtis Chau
Curtis Chau
Actualizado:
This article was translated from English: Does it need improvement?
Translated
View the article in English

Una aplicación .NET falla en el momento en que primero toca una clase de IronPDF, terminando a través de System.Environment.FailFast al inicio o durante la inicialización temprana. Cuando la aplicación se publica con la compilación ReadyToRun (R2R), ese paso de anticipación suele ser la causa. Mantienes ReadyToRun activado para la aplicación y excluyes IronPdf.dll de ella.

The application requested process termination through System.Environment.FailFast. Message: Stack: at System.Environment.FailFast(System.String) at <Module>..cctor() at Program.<Main>$(System.String[])

ReadyToRun compila ensamblados por anticipado para acelerar la carga inicial. En algunos entornos, ese paso de anticipación interfiere con bibliotecas que dependen del comportamiento de inicialización en tiempo de ejecución, entre ellas IronPDF. El proceso puede fallar muy temprano, a menudo antes de que cualquier registro de IronPDF esté disponible, por lo que no se escriben registros antes del bloqueo.

Este problema aparece solo en el entorno desplegado, típicamente en aplicaciones alojadas en ASP.NET Core o IIS en Windows (incluyendo Windows Server) que apuntan a win-x64. La misma máquina puede comportarse de manera diferente dentro de IIS que fuera de él. Un caso de producción confirmado ejecutó IronPDF 2026.4.1 en .NET 10, una aplicación web de ASP.NET Core bajo IIS (w3wp.exe), en Windows Server 2025 Datacenter en AWS EC2.

Solución

1. Mantener ReadyToRun habilitado

No hay necesidad de desactivar ReadyToRun completamente. Si su aplicación depende de ello, deje la propiedad en su lugar:

<PropertyGroup>
  <PublishReadyToRun>true</PublishReadyToRun>
</PropertyGroup>
<PropertyGroup>
  <PublishReadyToRun>true</PublishReadyToRun>
</PropertyGroup>
XML

2. Excluir IronPdf.dll de la compilación ReadyToRun

Añade la exclusión a tu .csproj:

<ItemGroup>
  <PublishReadyToRunExclude Include="IronPdf.dll" />
</ItemGroup>
<ItemGroup>
  <PublishReadyToRunExclude Include="IronPdf.dll" />
</ItemGroup>
XML

Esta única línea es lo que restaura el comportamiento normal: deja el resto de la aplicación compilada con R2R mientras permite que IronPDF se inicie en tiempo de ejecución como espera.

PrecauciónUse la sintaxis exacta que se muestra. No envuelva la exclusión dentro de otro bloque de contenedor <PublishReadyToRunExclude>.

3. Ejemplo completo de .csproj

Un archivo de proyecto funcional se ve así:

<PropertyGroup>
  <TargetFramework>net10.0</TargetFramework>
  <Nullable>enable</Nullable>
  <ImplicitUsings>enable</ImplicitUsings>
  <PublishReadyToRun>true</PublishReadyToRun>
</PropertyGroup>
<ItemGroup>
  <PackageReference Include="IronPdf" Version="2026.4.1" />
</ItemGroup>
<ItemGroup>
  <PublishReadyToRunExclude Include="IronPdf.dll" />
</ItemGroup>
<PropertyGroup>
  <TargetFramework>net10.0</TargetFramework>
  <Nullable>enable</Nullable>
  <ImplicitUsings>enable</ImplicitUsings>
  <PublishReadyToRun>true</PublishReadyToRun>
</PropertyGroup>
<ItemGroup>
  <PackageReference Include="IronPdf" Version="2026.4.1" />
</ItemGroup>
<ItemGroup>
  <PublishReadyToRunExclude Include="IronPdf.dll" />
</ItemGroup>
XML

4. Republíquelo y vuelva a implementarlo

Con el archivo de proyecto actualizado, empuje una nueva compilación:

  1. Reconstruya la aplicación.
  2. Vuelve a publicar para tu tiempo de ejecución previsto, como win-x64.
  3. Vuelva a implementar la compilación actualizada.
  4. Reinicie el sitio IIS o recicle el grupo de aplicaciones.
  5. Pruebe nuevamente el mismo camino del código de IronPDF.

En el caso de producción confirmado, excluir IronPdf.dll de la compilación ReadyToRun eliminó el fallo de System.Environment.FailFast y la aplicación se ejecutó normalmente bajo IIS.

Cuándo Intentar Esta Solución

Opte por esta solución cuando los síntomas coincidan:

  • PublishReadyToRun=true: ReadyToRun está habilitado en la aplicación publicada.
  • Primer llamada provoca fracaso: el fallo ocurre en el momento en que se toca una clase de IronPDF.
  • Tiempo de inicio: el error aparece durante la carga inicial o la inicialización estática temprana.
  • Host de Windows implementado: la aplicación se ejecuta bajo IIS u otro entorno de Windows implementado.

Para obtener orientación completa, vea Usando ReadyToRun con IronPDF.

Curtis Chau
Curtis Chau
  Chatea con el equipo de ingeniería ahora
Escritor Técnico

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien ...

Leer más
¿Listo para empezar?
Nuget Descargas 20,296,129 | Versión: 2026.7 recién publicada
Still Scrolling Icon

¿Aún desplazándote?

¿Quieres una prueba rápida? PM > Install-Package IronPdf
ejecutar una muestra Mira cómo tu HTML se convierte en PDF.