try script errores catch capturar bash error-handling error-logging

bash - catch - capturar errores en shell script



Manejo de errores en Bash (14)

¿Cuál es tu método favorito para manejar los errores en Bash? El mejor ejemplo de manejo de errores que he encontrado en la web fue escrito por William Shotts, Jr en http://www.linuxcommand.org .

Él sugiere usar la siguiente función para el manejo de errores en Bash:

#!/bin/bash # A slicker error handling routine # I put a variable in my scripts named PROGNAME which # holds the name of the program being run. You can get this # value from the first item on the command line ($0). # Reference: This was copied from <http://www.linuxcommand.org/wss0150.php> PROGNAME=$(basename $0) function error_exit { # ---------------------------------------------------------------- # Function for exit due to fatal program error # Accepts 1 argument: # string containing descriptive error message # ---------------------------------------------------------------- echo "${PROGNAME}: ${1:-"Unknown Error"}" 1>&2 exit 1 } # Example call of the error_exit function. Note the inclusion # of the LINENO environment variable. It contains the current # line number. echo "Example of error with line number and message" error_exit "$LINENO: An error has occurred."

¿Tiene una rutina de manejo de errores mejor que utiliza en los scripts de Bash?


Esa es una buena solución. Solo quería añadir

set -e

Como mecanismo de error rudimentario. Inmediatamente detendrá su script si falla un simple comando. Creo que este debería haber sido el comportamiento predeterminado: dado que tales errores casi siempre significan algo inesperado, no es realmente "sensato" seguir ejecutando los siguientes comandos.


Esta función me ha estado sirviendo bastante bien recientemente:

action () { # Test if the first parameter is non-zero # and return straight away if so if test $1 -ne 0 then return $1 fi # Discard the control parameter # and execute the rest shift 1 "$@" local status=$? # Test the exit status of the command run # and display an error message on failure if test ${status} -ne 0 then echo Command /""$@"/" failed >&2 fi return ${status} }

Lo llama agregando 0 o el último valor de retorno al nombre del comando a ejecutar, de modo que puede encadenar comandos sin tener que verificar los valores de error. Con esto, este bloque de declaración:

command1 param1 param2 param3... command2 param1 param2 param3... command3 param1 param2 param3... command4 param1 param2 param3... command5 param1 param2 param3... command6 param1 param2 param3...

Se convierte en esto:

action 0 command1 param1 param2 param3... action $? command2 param1 param2 param3... action $? command3 param1 param2 param3... action $? command4 param1 param2 param3... action $? command5 param1 param2 param3... action $? command6 param1 param2 param3... <<<Error-handling code here>>>

Si alguno de los comandos falla, el código de error simplemente se pasa al final del bloque. Me resulta útil cuando no desea que se ejecuten los comandos subsiguientes si falla uno anterior, pero tampoco desea que la secuencia de comandos salga de inmediato (por ejemplo, dentro de un bucle).


Este truco es útil para faltar comandos o funciones. El nombre de la función que falta (o ejecutable) se pasará en $ _

function handle_error { status=$? last_call=$1 # 127 is ''command not found'' (( status != 127 )) && return echo "you tried to call $last_call" return } # Trap errors. trap ''handle_error "$_"'' ERR


Inspirado por las ideas presentadas aquí, he desarrollado una forma fácil de leer para manejar los errores en los scripts de bash en mi proyecto de placa de referencia de bash .

Al simplemente abastecer la biblioteca, obtiene lo siguiente de la caja (es decir, detendrá la ejecución de cualquier error, como si usara set -e gracias a una trap en ERR y algo de bash-fu ):

Hay algunas características adicionales que ayudan a manejar los errores, como probar y capturar , o la palabra clave throw , que le permite interrumpir la ejecución en un punto para ver el retroceso. Además, si el terminal lo admite, emite emojis de línea eléctrica, colorea partes de la salida para una gran legibilidad y subraya el método que causó la excepción en el contexto de la línea de código.

El inconveniente es, no es portátil, el código funciona en bash, probablemente> = 4 solamente (pero me imagino que podría portarse con algún esfuerzo para golpear 3).

El código está separado en varios archivos para un mejor manejo, pero Luca Borrione me inspiró en la idea de retroceso de la respuesta anterior .

Para leer más o echar un vistazo a la fuente, vea GitHub:

https://github.com/niieani/bash-oo-framework#error-handling-with-exceptions-and-throw


Leer todas las respuestas en esta página me inspiró mucho.

Entonces, aquí está mi consejo:

contenido del archivo: lib.trap.sh

lib_name=''trap'' lib_version=20121026 stderr_log="/dev/shm/stderr.log" # # TO BE SOURCED ONLY ONCE: # ###~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~## if test "${g_libs[$lib_name]+_}"; then return 0 else if test ${#g_libs[@]} == 0; then declare -A g_libs fi g_libs[$lib_name]=$lib_version fi # # MAIN CODE: # ###~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~## set -o pipefail # trace ERR through pipes set -o errtrace # trace ERR through ''time command'' and other functions set -o nounset ## set -u : exit the script if you try to use an uninitialised variable set -o errexit ## set -e : exit the script if any statement returns a non-true return value exec 2>"$stderr_log" ###~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~## # # FUNCTION: EXIT_HANDLER # ###~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~## function exit_handler () { local error_code="$?" test $error_code == 0 && return; # # LOCAL VARIABLES: # ------------------------------------------------------------------ # local i=0 local regex='''' local mem='''' local error_file='''' local error_lineno='''' local error_message=''unknown'' local lineno='''' # # PRINT THE HEADER: # ------------------------------------------------------------------ # # Color the output if it''s an interactive terminal test -t 1 && tput bold; tput setf 4 ## red bold echo -e "/n(!) EXIT HANDLER:/n" # # GETTING LAST ERROR OCCURRED: # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ # # # Read last file from the error log # ------------------------------------------------------------------ # if test -f "$stderr_log" then stderr=$( tail -n 1 "$stderr_log" ) rm "$stderr_log" fi # # Managing the line to extract information: # ------------------------------------------------------------------ # if test -n "$stderr" then # Exploding stderr on : mem="$IFS" local shrunk_stderr=$( echo "$stderr" | sed ''s//: //:/g'' ) IFS='':'' local stderr_parts=( $shrunk_stderr ) IFS="$mem" # Storing information on the error error_file="${stderr_parts[0]}" error_lineno="${stderr_parts[1]}" error_message="" for (( i = 3; i <= ${#stderr_parts[@]}; i++ )) do error_message="$error_message "${stderr_parts[$i-1]}": " done # Removing last '':'' (colon character) error_message="${error_message%:*}" # Trim error_message="$( echo "$error_message" | sed -e ''s/^[ /t]*//'' | sed -e ''s/[ /t]*$//'' )" fi # # GETTING BACKTRACE: # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ # _backtrace=$( backtrace 2 ) # # MANAGING THE OUTPUT: # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ # local lineno="" regex=''^([a-z]{1,}) ([0-9]{1,})$'' if [[ $error_lineno =~ $regex ]] # The error line was found on the log # (e.g. type ''ff'' without quotes wherever) # -------------------------------------------------------------- then local row="${BASH_REMATCH[1]}" lineno="${BASH_REMATCH[2]}" echo -e "FILE:/t/t${error_file}" echo -e "${row^^}:/t/t${lineno}/n" echo -e "ERROR CODE:/t${error_code}" test -t 1 && tput setf 6 ## white yellow echo -e "ERROR MESSAGE:/n$error_message" else regex="^${error_file}/$|^${error_file}/s+|/s+${error_file}/s+|/s+${error_file}/$" if [[ "$_backtrace" =~ $regex ]] # The file was found on the log but not the error line # (could not reproduce this case so far) # ------------------------------------------------------ then echo -e "FILE:/t/t$error_file" echo -e "ROW:/t/tunknown/n" echo -e "ERROR CODE:/t${error_code}" test -t 1 && tput setf 6 ## white yellow echo -e "ERROR MESSAGE:/n${stderr}" # Neither the error line nor the error file was found on the log # (e.g. type ''cp ffd fdf'' without quotes wherever) # ------------------------------------------------------ else # # The error file is the first on backtrace list: # Exploding backtrace on newlines mem=$IFS IFS='' '' # # Substring: I keep only the carriage return # (others needed only for tabbing purpose) IFS=${IFS:0:1} local lines=( $_backtrace ) IFS=$mem error_file="" if test -n "${lines[1]}" then array=( ${lines[1]} ) for (( i=2; i<${#array[@]}; i++ )) do error_file="$error_file ${array[$i]}" done # Trim error_file="$( echo "$error_file" | sed -e ''s/^[ /t]*//'' | sed -e ''s/[ /t]*$//'' )" fi echo -e "FILE:/t/t$error_file" echo -e "ROW:/t/tunknown/n" echo -e "ERROR CODE:/t${error_code}" test -t 1 && tput setf 6 ## white yellow if test -n "${stderr}" then echo -e "ERROR MESSAGE:/n${stderr}" else echo -e "ERROR MESSAGE:/n${error_message}" fi fi fi # # PRINTING THE BACKTRACE: # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ # test -t 1 && tput setf 7 ## white bold echo -e "/n$_backtrace/n" # # EXITING: # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ # test -t 1 && tput setf 4 ## red bold echo "Exiting!" test -t 1 && tput sgr0 # Reset terminal exit "$error_code" } trap exit_handler EXIT # ! ! ! TRAP EXIT ! ! ! trap exit ERR # ! ! ! TRAP ERR ! ! ! ###~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~## # # FUNCTION: BACKTRACE # ###~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~## function backtrace { local _start_from_=0 local params=( "$@" ) if (( "${#params[@]}" >= "1" )) then _start_from_="$1" fi local i=0 local first=false while caller $i > /dev/null do if test -n "$_start_from_" && (( "$i" + 1 >= "$_start_from_" )) then if test "$first" == false then echo "BACKTRACE IS:" first=true fi caller $i fi let "i=i+1" done } return 0



Ejemplo de uso:
contenido del archivo: trap-test.sh

#!/bin/bash source ''lib.trap.sh'' echo "doing something wrong now .." echo "$foo" exit 0


Corriendo:

bash trap-test.sh

Salida:

doing something wrong now .. (!) EXIT HANDLER: FILE: trap-test.sh LINE: 6 ERROR CODE: 1 ERROR MESSAGE: foo: unassigned variable BACKTRACE IS: 1 main trap-test.sh Exiting!


Como puede ver en la captura de pantalla a continuación, la salida está coloreada y el mensaje de error aparece en el idioma utilizado.


No estoy seguro de si esto será útil para usted, pero modifiqué algunas de las funciones sugeridas aquí para incluir la verificación del error (código de salida del comando anterior) dentro de él. En cada "verificación" también paso como parámetro el "mensaje" de cuál es el error para fines de registro.

#!/bin/bash error_exit() { if [ "$?" != "0" ]; then log.sh "$1" exit 1 fi }

Ahora para llamarlo dentro del mismo script (o en otro si uso export -f error_exit ) simplemente escribo el nombre de la función y paso un mensaje como parámetro, como este:

#!/bin/bash cd /home/myuser/afolder error_exit "Unable to switch to folder" rm * error_exit "Unable to delete all files"

Usando esto pude crear un archivo bash realmente robusto para algún proceso automatizado y se detendrá en caso de errores y notificarme ( log.sh lo hará)


Otra consideración es el código de salida a devolver. Solo " 1 " es bastante estándar, aunque hay un puñado de códigos de salida reservados que bash utiliza , y esa misma página argumenta que los códigos definidos por el usuario deben estar en el rango 64-113 para cumplir con los estándares C / C ++.

También puede considerar el enfoque de vector de bits que utiliza el mount para sus códigos de salida:

0 success 1 incorrect invocation or permissions 2 system error (out of memory, cannot fork, no more loop devices) 4 internal mount bug or missing nfs support in mount 8 user interrupt 16 problems writing or locking /etc/mtab 32 mount failure 64 some mount succeeded

OR al juntar los códigos, su script puede señalar múltiples errores simultáneos.


Prefiero algo realmente fácil de llamar. Así que uso algo que parece un poco complicado, pero es fácil de usar. Por lo general, solo copio y pego el código siguiente en mis scripts. Una explicación sigue el código.

#This function is used to cleanly exit any script. It does this displaying a # given error message, and exiting with an error code. function error_exit { echo echo "$@" exit 1 } #Trap the killer signals so that we can exit with a good message. trap "error_exit ''Received signal SIGHUP''" SIGHUP trap "error_exit ''Received signal SIGINT''" SIGINT trap "error_exit ''Received signal SIGTERM''" SIGTERM #Alias the function so that it will print a message with the following format: #prog-name(@line#): message #We have to explicitly allow aliases, we do this because they make calling the #function much easier (see example). shopt -s expand_aliases alias die=''error_exit "Error ${0}(@`echo $(( $LINENO - 1 ))`):"''

Por lo general, pongo una llamada a la función de limpieza junto con la función error_exit, pero esto varía de un script a otro, así que lo dejé fuera. Las trampas atrapan las señales de terminación comunes y se aseguran de que todo se limpie. El alias es lo que hace la verdadera magia. Me gusta comprobar todo por el fracaso. Así que en general llamo a los programas en un "si!" tipo de declaración. Al restar 1 del número de línea, el alias me dirá dónde ocurrió la falla. También es muy simple de llamar, y bastante a prueba de idiotas. A continuación se muestra un ejemplo (simplemente reemplace / bin / false con lo que sea que llame).

#This is an example useage, it will print out #Error prog-name (@1): Who knew false is false. if ! /bin/false ; then die "Who knew false is false." fi


Una alternativa equivalente a "set -e" es

set -o errexit

Hace que el significado de la bandera sea algo más claro que solo "-e".

Adición aleatoria: para deshabilitar temporalmente el indicador y volver al valor predeterminado (para continuar la ejecución independientemente de los códigos de salida), solo use

set +e echo "commands run here returning non-zero exit codes will not cause the entire script to fail" echo "false returns 1 as an exit code" false set -e

Esto excluye el manejo adecuado de errores mencionados en otras respuestas, pero es rápido y efectivo (como bash).


Usa una trampa!

tempfiles=( ) cleanup() { rm -f "${tempfiles[@]}" } trap cleanup 0 error() { local parent_lineno="$1" local message="$2" local code="${3:-1}" if [[ -n "$message" ]] ; then echo "Error on or near line ${parent_lineno}: ${message}; exiting with status ${code}" else echo "Error on or near line ${parent_lineno}; exiting with status ${code}" fi exit "${code}" } trap ''error ${LINENO}'' ERR

... entonces, cada vez que crees un archivo temporal:

temp_foo="$(mktemp -t foobar.XXXXXX)" tempfiles+=( "$temp_foo" )

y $temp_foo se eliminará al salir, y se imprimirá el número de línea actual. ( set -e también le dará un comportamiento de salida en error, aunque viene con serias advertencias y debilita la previsibilidad y portabilidad del código).

Puede dejar el error llamada trampa por usted (en cuyo caso utiliza el código de salida predeterminado de 1 y ningún mensaje) o puede llamarlo usted mismo y proporcionar valores explícitos; por ejemplo:

error ${LINENO} "the foobar failed" 2

saldrá con el estado 2 y dará un mensaje explícito.


Usar la trampa no siempre es una opción. Por ejemplo, si está escribiendo algún tipo de función reutilizable que necesita manejo de errores y que se puede llamar desde cualquier script (después de obtener el archivo con funciones de ayuda), esa función no puede asumir nada sobre el tiempo de salida del script externo, lo que hace que el uso de trampas sea muy difícil. Otra desventaja de usar trampas es la mala capacidad de composición, ya que corre el riesgo de sobrescribir las trampas anteriores que podrían configurarse anteriormente en la cadena de llamadas.

Hay un pequeño truco que se puede usar para hacer un manejo adecuado de errores sin trampas. Como ya sabrá por otras respuestas, set -e no funciona dentro de los comandos si usa || operador después de ellos, incluso si los ejecuta en una subshell; Por ejemplo, esto no funcionaría:

#!/bin/sh # prints: # # --> outer # --> inner # ./so_1.sh: line 16: some_failed_command: command not found # <-- inner # <-- outer set -e outer() { echo ''--> outer'' (inner) || { exit_code=$? echo ''--> cleanup'' return $exit_code } echo ''<-- outer'' } inner() { set -e echo ''--> inner'' some_failed_command echo ''<-- inner'' } outer

Pero || Se necesita un operador para evitar volver de la función externa antes de la limpieza. El truco consiste en ejecutar el comando interno en segundo plano y luego esperar inmediatamente. La función de wait incorporada devolverá el código de salida del comando interno, y ahora está usando || después de wait , no la función interna, por lo que set -e funciona correctamente dentro de esta última:

#!/bin/sh # prints: # # --> outer # --> inner # ./so_2.sh: line 27: some_failed_command: command not found # --> cleanup set -e outer() { echo ''--> outer'' inner & wait $! || { exit_code=$? echo ''--> cleanup'' return $exit_code } echo ''<-- outer'' } inner() { set -e echo ''--> inner'' some_failed_command echo ''<-- inner'' } outer

Aquí está la función genérica que se basa en esta idea. Debería funcionar en todos los shells compatibles con POSIX si elimina local palabras clave local , es decir, reemplace todas local x=y con solo x=y :

# [CLEANUP=cleanup_cmd] run cmd [args...] # # `cmd` and `args...` A command to run and its arguments. # # `cleanup_cmd` A command that is called after cmd has exited, # and gets passed the same arguments as cmd. Additionally, the # following environment variables are available to that command: # # - `RUN_CMD` contains the `cmd` that was passed to `run`; # - `RUN_EXIT_CODE` contains the exit code of the command. # # If `cleanup_cmd` is set, `run` will return the exit code of that # command. Otherwise, it will return the exit code of `cmd`. # run() { local cmd="$1"; shift local exit_code=0 local e_was_set=1; if ! is_shell_attribute_set e; then set -e e_was_set=0 fi "$cmd" "$@" & wait $! || { exit_code=$? } if [ "$e_was_set" = 0 ] && is_shell_attribute_set e; then set +e fi if [ -n "$CLEANUP" ]; then RUN_CMD="$cmd" RUN_EXIT_CODE="$exit_code" "$CLEANUP" "$@" return $? fi return $exit_code } is_shell_attribute_set() { # attribute, like "x" case "$-" in *"$1"*) return 0 ;; *) return 1 ;; esac }

Ejemplo de uso:

#!/bin/sh set -e # Source the file with the definition of `run` (previous code snippet). # Alternatively, you may paste that code directly here and comment the next line. . ./utils.sh main() { echo "--> main: $@" CLEANUP=cleanup run inner "$@" echo "<-- main" } inner() { echo "--> inner: $@" sleep 0.5; if [ "$1" = ''fail'' ]; then oh_my_god_look_at_this fi echo "<-- inner" } cleanup() { echo "--> cleanup: $@" echo " RUN_CMD = ''$RUN_CMD''" echo " RUN_EXIT_CODE = $RUN_EXIT_CODE" sleep 0.3 echo ''<-- cleanup'' return $RUN_EXIT_CODE } main "$@"

Ejecutando el ejemplo:

$ ./so_3 fail; echo "exit code: $?" --> main: fail --> inner: fail ./so_3: line 15: oh_my_god_look_at_this: command not found --> cleanup: fail RUN_CMD = ''inner'' RUN_EXIT_CODE = 127 <-- cleanup exit code: 127 $ ./so_3 pass; echo "exit code: $?" --> main: pass --> inner: pass <-- inner --> cleanup: pass RUN_CMD = ''inner'' RUN_EXIT_CODE = 0 <-- cleanup <-- main exit code: 0

Lo único que debe tener en cuenta al usar este método es que todas las modificaciones de las variables de Shell realizadas desde el comando que pasa a run no se propagarán a la función de llamada, porque el comando se ejecuta en una subshell.


Utilizo el siguiente código de captura, también permite rastrear errores a través de tuberías y comandos de "tiempo"

#!/bin/bash set -o pipefail # trace ERR through pipes set -o errtrace # trace ERR through ''time command'' and other functions function error() { JOB="$0" # job name LASTLINE="$1" # line of error occurrence LASTERR="$2" # error code echo "ERROR in ${JOB} : line ${LASTLINE} with exit code ${LASTERR}" exit 1 } trap ''error ${LINENO} ${?}'' ERR


he usado

die() { echo $1 kill $$ }

antes de; Creo que porque "salir" me estaba fallando por alguna razón. Sin embargo, los valores predeterminados anteriores parecen ser una buena idea.


This me ha servido bien por un tiempo ahora. Imprime mensajes de error o advertencia en rojo, una línea por parámetro, y permite un código de salida opcional.

# Custom errors EX_UNKNOWN=1 warning() { # Output warning messages # Color the output red if it''s an interactive terminal # @param $1...: Messages test -t 1 && tput setf 4 printf ''%s/n'' "$@" >&2 test -t 1 && tput sgr0 # Reset terminal true } error() { # Output error messages with optional exit code # @param $1...: Messages # @param $N: Exit code (optional) messages=( "$@" ) # If the last parameter is a number, it''s not part of the messages last_parameter="${messages[@]: -1}" if [[ "$last_parameter" =~ ^[0-9]*$ ]] then exit_code=$last_parameter unset messages[$((${#messages[@]} - 1))] fi warning "${messages[@]}" exit ${exit_code:-$EX_UNKNOWN} }