Solución de Problemas
Si tienes algún problema con tu sitio estático, consulta los siguientes consejos y soluciones para los errores más comunes.
Error 403
Si el despliegue de tu sitio se completa sin errores, pero ves un error 403 cuando intentas visitar el sitio en tu navegador, aquí tienes algunas cosas que comprobar:
- Si tu sitio depende de un paso de construcción, ¿el comando de Construcción (Configuración > Detalles básicos) está rellenado y es correcto?
- ¿Es correcto el directorio de Publicación?
- ¿Son correctos sus permisos de archivo*? Generalmente recomendamos los siguientes permisos para sitios estáticos:
- Directorios: 755
- Archivos: 644
*Los permisos de archivo controlan quién puede:
- Leer: Ver el contenido de un archivo o ver los archivos de un directorio.
- Escribir: Modificar un fichero, o añadir o borrar ficheros en un directorio.
- Ejecutar: Ejecutar un archivo y/o ejecutarlo como un script, o acceder a un directorio y realizar funciones y comandos.
Cada archivo y directorio tiene su propio conjunto de permisos, que se muestran como un número de 3 dígitos. Cada número indica el nivel de permiso para cada categoría (lectura, escritura y ejecución) mostrada anteriormente.
Error 404
Si el despliegue de tu sitio se completa sin errores, pero ves un error 404 cuando intentas visitar el sitio en tu navegador, hay algunas cosas que comprobar:
- Si tu sitio depende de un paso de construcción, ¿el comando de Construcción (Configuración > Detalles básicos) está rellenado y es correcto?
- ¿Es correcto el directorio de Publicación?
- ¿Es tu repositorio compatible con el Alojamiento de Sitios Estáticos? Debería contener:
- Un framework de sitio estático que utilice Node.js para el paso de construcción.
- O archivos estáticos, como HTML, CSS y Javascript, que no requieren un paso de construcción (deja el comando de Construcción en blanco).
El comando de Construcción le dice a nuestro sistema cómo crear tu sitio, y el directorio de Publicación es el subdirectorio donde se encuentran los archivos del sitio terminado, en relación al root de tu repositorio. Es crucial rellenar estos campos correctamente si tu sitio depende de un paso de construcción. Esto asegurará que tu sitio se construya y se sirva como deseas. Si el comando de Construcción se deja en blanco, el sistema puede indicar que el despliegue se ha completado, pero sólo cargará los contenidos no construidos de tu repositorio.
Versión de Node Incorrecta
Si introduces un comando de construcción para tu sitio, puedes seleccionar la versión de Node a utilizar. Si seleccionas la versión incorrecta, el despliegue fallará, y habrá un error en el registro de construcción y lanzamiento que indica que se necesita una versión diferente de Node.js, similar a esta:
"Build project": error [email protected]: The engine "node" is incompatible with this module. Expected version "16.14.0". Got "16.20.0"Comprueba la configuración de tu sitio estático, cambia la versión de Node según sea necesario y despliega manualmente el sitio de nuevo (haz clic en Desplegar ahora en la página Despliegues).
No se puede Determinar el Gestor de Paquetes
Si se produce un problema con el comando de construcción o el archivo de configuración, puedes ver el siguiente error:
Error: No se puede determinar el gestor de paquetes
Este error suele producirse debido a un comando de construcción incorrecto o a la falta de un archivo package.json o a una configuración incorrecta del mismo. Aquí hay un par de cosas para comprobar:
- ¿El comando de Construcción (Configuración > Detalles básicos) está rellenado y es correcto?
- ¿Está el archivo package.json en tu repositorio git?
- ¿Está el archivo package.json configurado correctamente, incluyendo cualquier versión conflictiva de Node? Por ejemplo, puedes haber elegido la versión 18.16.0 de Node cuando añadiste el sitio estático, pero en el archivo package.json, puedes haber configurado la versión de Node a algo diferente, como en el siguiente ejemplo:
"engines": { "node": ">=20.0.0" },