Solución de problemas

Resolución de problemas

Problemas comunes y soluciones al trabajar con Aspose.PDF FOSS para .NET.

Problem	Cause	Solution
`Document.Open` lanza una excepción en un PDF válido	El archivo está protegido con contraseña	Proporcione la contraseña en el constructor
Falta de memoria en PDFs grandes	Todo el archivo cargado en un arreglo de bytes	Procese las páginas individualmente o use transmisión
`Pages[0]` lanza un error de índice	Las páginas usan indexación basada en 1	Use `Pages[1]` para la primera página

Problema	Causa	Solución
La anotación no es visible después de guardar	El rectángulo tiene área cero o está fuera de los límites de la página	Verifique que las coordenadas estén dentro de la página `MediaBox`
`LinkAnnotation.Uri` devuelve nulo	El enlace usa una acción GoTo o JavaScript	Resuelva mediante `PdfAction.Create` y verifique `ActionType`
`Flatten()` lanza	Falta la referencia `/P` (página) de la anotación	Asegúrese de que la anotación se haya añadido mediante `Page.Annotations`

Problema	Causa	Solución
El texto extraído está distorsionado	Codificación no estándar o asignación de fuentes CID	Verifique la incrustación de fuentes; los PDF escaneados pueden necesitar OCR
No se encontraron fragmentos de texto	El contenido de la página es una imagen raster	Utilice OCR antes de la extracción de texto
La expresión regular no devuelve coincidencias	El diseño del texto PDF inserta espacios	Utilice un patrón más flexible o normalice los espacios

Problema	Causa	Solución
La imagen renderizada está borrosa	Resolución demasiado baja	Aumentar DPI en el constructor `Resolution`
La salida HTML no tiene imágenes	Rutas de imágenes externas no configuradas	Usar `HtmlSaveOptions` con imágenes incrustadas
La conversión a PDF/A elimina anotaciones	El perfil de destino no permite anotaciones	Usar PDF/A-2 o PDF/A-3

Problema	Causa	Solución
El valor del campo está vacío	El campo no tiene entrada `/V`	Verifique que `field.Value` no sea nulo
`FillField` no tiene efecto	Desajuste del nombre del campo	Use `Form.FieldNames` para listar los nombres disponibles
ExportToJson produce salida vacía	La anotación del widget no está convertida correctamente	Verifique que la anotación sea un `WidgetAnnotation`

Siempre envuelva Document en using para liberar los manejadores de archivo.
Use Document.Open(byte[]) para flujos de trabajo en memoria y evitar bloqueos de archivos.
Verifique doc.Pages.Count antes de acceder a las páginas por índice.
Guarde el documento una sola vez después de todas las modificaciones para obtener el mejor rendimiento.

Solución de problemas