Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Solución de problemas generales de Amplify
La siguiente información puede ayudarlo a solucionar problemas generales con Amplify Hosting.
Temas
Código de estado HTTP 429 (demasiadas solicitudes)
Amplify controla la cantidad de solicitudes por segundo (RPS) a su sitio web en función del tiempo de procesamiento y la transferencia de datos que consumen las solicitudes entrantes. Si su aplicación devuelve un código de estado HTTP 429, las solicitudes entrantes exceden el tiempo de procesamiento y transferencia de datos asignado a su aplicación. Este límite de aplicaciones se administra mediante la cuota de servicio REQUEST_TOKENS_PER_SECOND de Amplify. Para obtener más información sobre las cuotas, consulte Service Quotas de Amplify Hosting.
Para solucionar este problema, recomendamos optimizar la aplicación para reducir la duración de las solicitudes y la transferencia de datos a fin de aumentar la RPS de la aplicación. Por ejemplo, con los mismos 20 000 tokens, una página SSR altamente optimizada que responda en 100 milisegundos puede admitir una RPS más alta en comparación con una página con una latencia superior a 200 milisegundos.
Del mismo modo, una aplicación que devuelva un tamaño de respuesta de 1 MB consumirá más tokens que una aplicación que devuelva uno de 250 KB.
También le recomendamos que aproveche la CloudFront caché de Amazon configurando Cache-Control encabezados que maximicen el tiempo que una respuesta determinada permanece en la memoria caché. Las solicitudes que se atienden desde la CloudFront memoria caché no se tienen en cuenta para el límite de velocidad. Cada CloudFront distribución puede gestionar hasta 250 000 solicitudes por segundo, lo que te permite escalar tu aplicación a un nivel muy alto utilizando la caché. Para obtener más información sobre la CloudFront caché, consulte Optimización del almacenamiento en caché y la disponibilidad en la Guía para CloudFront desarrolladores de Amazon.
La consola Amplify no muestra el estado de la compilación ni la hora de la última actualización de mi aplicación
Al navegar a la página Todas las aplicaciones en la consola de Amplify, se muestra un mosaico para cada una de las aplicaciones de la región actual. Si no se ve el estado de compilación de una aplicación, como Implementada, ni la hora de la última actualización, significa que la aplicación no tiene ninguna ramificación de etapa de Production asociada.
Para enumerar las aplicaciones en la consola, Amplify usa la API de ListApps. Amplify usa el atributo ProductionBranch.status para mostrar el estado de la compilación y el atributo ProductionBranch.lastDeployTime para mostrar la hora de la última actualización. Para obtener más información sobre esta API, consulta la documentación ProductionBranchde la API de Amplify Hosting.
Siga estas instrucciones para asociar una etapa de Production a la ramificación de la aplicación.
-
Inicie sesión en la consola de Amplify
. -
En la página Todas las aplicaciones, seleccione la aplicación que desea actualizar.
-
En el panel de navegación, elija Configuración de la aplicación y Configuración de ramificación.
-
En la sección Configuración de ramificaciones, elija Editar.
-
En Ramificación de producción, elija el nombre de ramificación que desea utilizar.
-
Seleccione Save.
-
Vuelva a la página Todas las aplicaciones. Ahora deberían mostrarse el estado de compilación y la hora de la última actualización de la aplicación.
No se están creando vistas previas web para las nuevas solicitudes de cambios
La característica de vistas previas web permite previsualizar los cambios de las solicitudes de extracción antes de fusionarlos en una ramificación de integración. La vista previa web presenta todas las solicitudes de extracción realizadas en el repositorio en una URL de vista previa única. Esta URL es diferente a la que utiliza su sitio principal.
Si has activado las vistas previas web de tu aplicación, pero no se están creando para una nueva PRs, investiga si alguna de las siguientes causas es la causa del problema.
-
Compruebe si la aplicación ha alcanzado la cuota máxima de servicio de
Branches per app. Para obtener más información sobre las cuotas, consulte Service Quotas de Amplify Hosting.Para mantenerse dentro de la cuota predeterminada de 50 ramificaciones por aplicación, se puede habilitar la eliminación automática de ramificaciones en la aplicación. Esto evitará que se acumulen ramificaciones en la cuenta que ya no existen en el repositorio.
-
Si utilizas un GitHub repositorio público y tu aplicación Amplify tiene una función de servicio de IAM asociada, Amplify no crea vistas previas por motivos de seguridad. Por ejemplo, las aplicaciones con backend y aquellas que se implementan en la plataforma de alojamiento de
WEB_COMPUTErequieren un rol de servicio de IAM. Por lo tanto, si su repositorio es público, no podrá habilitar las vistas previas web para este tipo de aplicaciones.Para que las vistas previas web funcionen en tu aplicación, puedes desasociar la función de servicio (si la aplicación no tiene un backend o no es una
WEB_COMPUTEaplicación) o puedes hacer que el repositorio sea privado. GitHub
Mi implementación manual está bloqueada con un estado pendiente en la consola Amplify
Las implementaciones manuales le permiten publicar su aplicación web con Amplify Hosting sin necesidad de conectar un proveedor de Git. Puede utilizar una de las siguientes opciones de implementación.
-
Arrastre y suelte la carpeta de aplicaciones en la consola de Amplify.
-
Arrastre y suelte un archivo .zip (que contiene los artefactos de construcción de su sitio) en la consola de Amplify.
-
Cargue un archivo .zip (que contiene los artefactos de creación de su sitio) en un bucket de Amazon S3 y conecte el bucket a una aplicación en la consola de Amplify.
-
Use una URL pública que apunte a un archivo .zip (que contiene los artefactos de creación de su sitio) en la consola de Amplify.
Tenemos conocimiento de que hay problemas con la función de arrastrar y soltar cuando se utiliza una carpeta de aplicaciones para una implementación manual en la consola Amplify. Estas implementaciones pueden fallar por las siguientes razones.
-
Se producen problemas de red transitorios.
-
Se produce un cambio local en los archivos durante la carga.
-
La sesión del navegador intenta cargar una gran cantidad de activos estáticos simultáneamente.
Mientras trabajamos para mejorar la fiabilidad de nuestras cargas mediante la función de arrastrar y soltar, recomendamos que utilice un archivo .zip en lugar de arrastrar y soltar las carpetas de la aplicación.
Recomendamos encarecidamente subir un archivo .zip a un bucket de Amazon S3, ya que esto evita las cargas de archivos desde la consola Amplify y proporciona una mayor fiabilidad para las implementaciones manuales. La integración de Amplify con Amazon S3 simplifica este proceso. Para obtener más información, consulte Implementación de un sitio web estático en Amplify desde un bucket de Amazon S3.
Necesito actualizar la versión Node.js de mi aplicación
El 15 de septiembre de 2025 finaliza la compatibilidad de Amplify con aplicaciones que utilizan versiones 14, 16 y 18 de Node.js El comportamiento después de esta fecha depende del tipo de aplicación:
-
Aplicaciones SSR: se producirán errores de compilación cuando se utilicen versiones obsoletas de Node.js. No se podrán implementar actualizaciones hasta que actualice a Node.js 20 o una versión posterior.
-
Aplicaciones que no son SSR: puede seguir usando las versiones obsoletas de Node.js si las instala manualmente mediante actualizaciones de buildspec o paquetes activos.
Las aplicaciones que ya estén implementadas seguirán ejecutándose independientemente de la versión existente de Node.js.
Si utiliza la imagen de compilación de Amazon Linux 2023, la versión 20 de Node.js es compatible de forma predeterminada. A partir del 15 de septiembre de 2025, la imagen AL2 023 será compatible automáticamente con Node.js 22 y cambiará su versión predeterminada de Node.js de la 18 a la 22.
Amazon Linux 2 (AL2) no admite automáticamente la versión 20 o posterior de Node.js. Si está utilizando actualmente AL2, le recomendamos que cambie a la versión AL2 023. Puede cambiar la imagen de compilación en la consola de Amplify. También puede usar una imagen de compilación personalizada que sea compatible con la versión de Node.js que especifique.
Antes de la actualización, recomendamos que pruebe la aplicación en una ramificación nueva para comprobar que funciona correctamente.
Opciones de actualización
- Consola de Amplify
Puede especificar la versión de Node.js que se utilizará en la característica de actualizaciones de paquetes en directo de la consola de Amplify. Para obtener instrucciones, consulte Uso de versiones específicas de paquetes y dependencias en la imagen de compilación.
- Imagen de compilación personalizada
Si se utiliza una imagen de compilación personalizada y la NVM está instalada en la imagen, se puede agregar
nvm install 20a su Dockerfile. Para obtener más información sobre los requisitos y las instrucciones de configuración de una imagen de compilación personalizada, consulte Personalización de la imagen de compilación.- Configuración de compilación
Se puede especificar la versión de Node.js que se va a utilizar en la configuración de compilación de
amplify.ymlde la aplicación, al agregar el comandonvm usea la sección de comandos de preBuild. Para obtener instrucciones sobre cómo actualizar la configuración de compilación de una aplicación, consulte Ajuste de la configuración de compilación de una aplicación de Amplify.En el siguiente ejemplo, se muestra cómo personalizar la configuración de compilación para establecer la versión predeterminada de Node.js en Node.js 18 y actualizar a Node.js en la versión 20 en una ramificación de prueba denominada
node-20.frontend: phases: preBuild: commands: - nvm use 18 - if [ "${AWS_BRANCH}" = "node-20" ]; then nvm use 20; fiaviso
Tenga en cuenta que los comandos
preBuildse ejecutan después de las actualizaciones de paquetes en directo. La versión de Node.js especificada por el comandonvm useanulará la versión de Node.js establecida por las actualizaciones de paquetes en directo.
