Documentación
Solución de problemas#
La App falla con securecookie: hash key is not set#
Después de un cambio reciente en github.com/gorilla/sessions, las aplicacionesde Buffalo con el error securecookie: hash key is not set no van a poder iniciarse.
Para solucionar esto, debes definir una variable de entorno llamada SESSION_SECRET.
Para más información: github.com/gobuffalo/buffalo/issues/1067
Linea de comandos lenta#
buffalo --help o cualquier otro comando en la terminal toma mas tiempo de lo esperado, define export BUFFALO_PLUGIN_PATH=$GOPATH/bin en la configuración de tu terminal (p.e. .bash_profile).
No de encuentra el binario de buffalo#
Si no puedes encontrar el binario de buffalo después de una instalación exitosa, probablemente es causado porque el $GOPATH/bin o %GOPATH\bin (Windows), no están en tu variable $PATH. Cuando se instala un binario de Go se coloca en $GOPATH/bin. Añadiendo esto a tu $PATH global, te permitirá encontrar cualquier binario de Go en todas partes de tu sistema.
Ve a golang.org/doc/code.html#GOPATH para obtener más detalles.
buffalo new falla al generar un proyecto completo#
Esto ocurre porque el comando bufalo new no puede encontrar las plantillas que necesita para general una nueva aplicación.
Hay un par de cosas que pueden causar este error.
-
Usando múltiples
$GOPATHs. Esto puede suceder cuando instala Buffalo en un$GOPATHy luego crea un nuevo$GOPATHtemporal e intenta crear una nueva aplicación allí. Debido a que las plantillas están en el primer$GOPATHoriginal, el instalador no las encuentra y, posteriormente, genera una aplicación incompleta. Para arreglar esto, define un solo$GOPATH. -
Usando un único
$GOPATH: Si no estas usando múltiples$GOPATHs y continuas viento este problema, es mas probable que se deba a una mala instalación, Ejecuta de nuevo$ go get -u -v github.com/gobuffalo/buffaloy debería , con suerte, reparar la instalación por ti.
El ticket original para este problema puede ser encontrado en: github.com/gobuffalo/buffalo/issues/629.
buffalo new falla por problemas de permisos de NPM#
Esto es causado por una incorrecta instalación de Node/NPM.
Ve a docs.npmjs.com/resolving-eacces-permissions-errors-when-installing-packages-globally para informarte como arreglar este problema.
la reconstrucción automática de buffalo dev no funciona con NFS.#
Esto se debe a que el paquete fsnotify no es compatible con NFS.
Ve a github.com/gobuffalo/buffalo/issues/620 para mas detalles y una solución.
buffalo new fails with import path does not begin with hostname#
Esto es causado porque el $GOPATH y la carpeta del sistema no coinciden.
GOPATH: /Users/foobar/Documents/Programming/Go
Actual: /Users/foobar/Documents/programming/go
Esos no son lo mismo y causan problemas con muchas herramientas de Go. Arregla $GOPATH para que coincida con el sistema de archivos e intenta nuevamente.
buffalo new falla al buscar golang.org/x/tools/go/gcimporter#
Esto es causado por una copia obsoleta del paquete github.com/motemen/gore.
Para arreglar esto, simplemente actualiza gore.
$ go get -u github.com/motemen/gore
Para mas información ve a github.com/gobuffalo/buffalo/issues/108 y github.com/motemen/gore/issues/63.
buffalo dev falla al iniciar con Unknown#
cuando ejecutas $ buffalo dev, y te encuentras con este error:
There was a problem starting the dev server: Unknown, Please review the troubleshooting docs.
Esto se puede deberse a que a tu sistema le falta NodeJS/NPM, Asegurate que NodeJS/NPM esten instalados en tu $PATH. Si NodeJS/NPM estan en tu $PATH, intenta renombrar el archivo webpack.config.js.
Si continuas teniendo estos problemas despues de intentar los pasos de arriba, por favor contacta a la comunidad de Gophers Slack #buffalo channel
package context: unrecognized import path "context" (import path does not begin with hostname)#
Cuando intentas instar Buffalo go get retorna este error:
package context: unrecognized import path "context" (import path does not begin with hostname)
Esto se debe a una version obsoleta de Go. Buffalo requiere Go de v1.16.0 o superior, Verifica tu instalación de Go y asegúrate de ejecutar la última versión.
Error: unexpected directory layout: durante go get#
Ocasionalmente cuando ejecutar go get en buffalo obtendrás el siguiente error:
unexpected directory layout:
import path: github.com/mattn/go-colorable
dir: /go/src/github.com/fatih/color/vendor/github.com/mattn/go-colorable
expand dir: /go/src/github.com/fatih/color/vendor/github.com/mattn/go-colorable
separator: /
Este problema ha sido reportado anteriormente por el equipo de Go github.com/golang/go/issues/17597.
La mejor opción para resolver este problema es ejecutar nuevamente go get, y parece arreglarse solo.
Error: en application.js de UglifyJs#
buffalo build, necesitas actualizar tu webpack.config.js para que funcione con el transpilador ES6 github.com/gobuffalo/buffalo/pull/350/files.
Error: Killed 9 cuando ejecutas buffalo en Mac OS X con Go 1.8.0#
Este es un problema conocido con Go github.com/golang/go/issues/19734, no con Buffalo.
La mejor solucion es actualizar a Go 1.8.1, o superior, y reconstruir tus binarios de Go.
Mac OS X: error Too many open files in system#
Si recibe este error cuando ejecuta buffalo dev, significa que estas “viendo” demasiados archivos, ya sean archivos .go u otro tipo de archivos.
Para corregir esto, puedes cambiar el número máximo de archivos abiertos en tu sistema.
buffalo new falla tratando de ejecutar goimports#
El error completo puede aparecer como el siguiente, y parece ser el resultado de herramientas obsoletas de Go. Para resolverlo, ejecuta rm -r $GOPATH/src/golang.org/, luego ejecuta nuevamente go get.
$ buffalo new myapp
--> go get -u golang.org/x/tools/cmd/goimports
package golang.org/x/tools/cmd/goimports: golang.org/x/tools is a custom import path for https://go.googlesource.com/tools, but /Users/foo/go/src/golang.org/x/tools is checked out from https://code.google.com/p/go.tools
Error: exit status 1
buffalo g goth falla al generar auth.go#
Es posible que veas errores similares a este cuando construyas:
buffalo: 2018/01/19 20:58:47 === Error! ===
buffalo: 2018/01/19 20:58:47 === exit status 2
path/path/models
path/path/actions
# path/path/actions
actions/app.go:17:2: gothic redeclared as imported package name
previous declaration at actions/app.go:15:2
actions/app.go:66:36: undefined: AuthCallback
actions/app.go:67:11: undefined: SetCurrentUser
actions/app.go:68:11: undefined: Authorize
actions/app.go:69:23: undefined: Authorize
Esto podría deberse a que el complemento goth no puede encontrar las plantillas para los diferentes proveedores. Esto puede suceder cuando el plugin goth está disponible en $PATH, pero el proyecto no está en tu $GOPATH actual.
Para solucionarlo, puedes ejecutar go get -u github.com/gobuffalo/buffalo-goth en el $GOPATH de tu proyecto o usar dep.