Guia de Depuração (DEBUG) no Spring Tools

SITUAÇÃO:

A depuração (DEBUG) é um processo essencial para identificar e corrigir erros em sistemas desenvolvidos com Spring Tools. Durante a reunião, discutimos diferentes formas de depurar erros em pedidos, banco de dados e requisições no Spring. Este guia resume as principais abordagens apresentadas.

VÍDEO DA APRESENTAÇÃO: Clique aqui para acessar

SOLUÇÃO:

Identificação de Erros em Pedidos:

Erro de atributo incorreto: Quando um atributo não possui o formato esperado (exemplo: código local de origem enviado como texto quando se espera outro formato), ative o DEBUG FRONT para capturar o JSON enviado pelo frontend.

Logs de pedidos: Ative o log de pedidos para visualizar as informações enviadas ao backend. Se a falha ocorrer no backend, utilize o DEBUG SK para analisar as requisições enviadas ao sistema.

Depuração de Queries (SQL):

DEBUG CARY: Utilize quando for necessário validar uma consulta SQL. Se os dados não aparecem no sistema, este parâmetro permite visualizar a consulta executada no banco.

Localização de erros em consultas: Se a query retorna zero resultados, verifique os filtros aplicados. Teste a consulta removendo filtros gradualmente até encontrar o impedimento. Utilize ferramentas como SQL Formatter para facilitar a leitura.

Erros em Resultados (ResultSet):

Ative o DEBUG RESULT SET quando os dados estiverem corrompidos ou mal formatados. Ele imprime cada campo e seu respectivo valor. Exemplo: Se o campo Complemento retorna valores inesperados, o debug mostrará o erro diretamente.

Depuração de Requisições HTTP:

DEBUG HEADER: Utilize quando houver problemas no cabeçalho da requisição ou se a resposta demorar indefinidamente. Permite ver a última operação antes da falha.

DEBUG LOGIN: Útil para problemas de sessão e autenticação. Permite verificar o momento exato da autenticação e identificar sessões presas.

Testes e Simulações:

Postman: Utilize para enviar requisições manualmente. Capture o JSON da requisição com DEBUG FRONT e teste no Postman para validar diferentes cenários.

Logs no AWS: Em servidores AWS, obtenha logs de execução para análise de infraestrutura. Recomenda-se ativar apenas temporariamente para evitar grande volume de dados.

Visualização de Logs no Sistema:

Utilize a tela Log de Pedidos para visualizar requisições enviadas. Se um pedido sumiu ou um item não foi salvo, o código do pedido pode ser decodificado via Base64 para facilitar a análise.

Observação: Os diferentes tipos de debug permitem diagnosticar problemas de forma eficiente. Lembre-se de ativar logs específicos conforme o erro, utilizar o Postman para testes manuais e analisar as consultas SQL para detectar falhas de sintaxe ou filtros incorretos.