Resolver problemas em aplicações Node.js no Funções do Azure

Este artigo fornece um guia para resolver cenários comuns em Node.js aplicações funcionais.

O separador Diagnosticar e resolver problemas no portal do Azure é um recurso útil para monitorizar e diagnosticar possíveis problemas relacionados com a sua aplicação. Também fornece potenciais soluções para os seus problemas com base no diagnóstico. Para mais informações, consulte Diagnósticos da app do Azure Functions.

Outro recurso útil é o separador Logs no portal do Azure para a sua instância do Application Insights, para que possa executar consultas KQL personalizadas. A seguinte consulta de exemplo mostra como visualizar erros e avisos da sua aplicação no último dia:

let myAppName = "<your app name>";
let startTime = ago(1d);
let endTime = now();
union traces,requests,exceptions
| where cloud_RoleName =~ myAppName
| where timestamp between (startTime .. endTime)
| where severityLevel > 2

Se esses recursos não resolveram o seu problema, as secções seguintes fornecem conselhos para questões específicas de aplicação:

Nenhuma função encontrada

Se vir algum dos seguintes erros nos seus registos:

Não foram encontrados gatilhos HTTP.

Nenhuma função de trabalho encontrada. Experimente tornar públicas as suas classes de tarefa e métodos. Se estiveres a usar extensões de associação (por exemplo, Armazenamento do Azure, ServiceBus, Timers, etc.), certifica-te de que chamaste o método de registo da(s) extensão(ões) no teu código de inicialização (por exemplo, builder.AddAzureStorage(), builder.AddServiceBus(), builder.AddTimers(), etc.).

Experimente as seguintes soluções:

Problemas de compilação do TypeScript

Para problemas específicos do TypeScript:

Falhas na compilação:

• Verifica se tsconfig.json tem o outDir corretamente apontado para a saída da compilação
• Assegurar que scriptFile no modelo v3 aponta para ficheiros compilados .js, não .ts
• Verifique se todas as dependências do TypeScript estão instaladas: npm install --save-dev typescript @types/node

Erros de tipo:

• Atualizar o pacote @azure/functions para as definições de tipos mais recentes
• Utilize importações adequadas: import { app, HttpRequest, InvocationContext } from '@azure/functions'
• Verificar se as assinaturas de funções correspondem aos tipos esperados

Problemas de resolução de módulos

Não se encontram erros de módulo:

• Execute npm install para garantir que todas as dependências estão instaladas
• A pasta Check node_modules existe no pacote de implementação
• Para módulos ES, certifique-se de que os nomes de ficheiro usam .mjs extensão ou package.json tem "type": "module"
• Verifique se os caminhos de importação relativos estão corretos após a compilação do TypeScript

Questões de ambiente e configuração

Variáveis de ambiente em falta:

• Adicionar variáveis a local.settings.json para desenvolvimento local
• Definir Definições de Aplicação no portal Azure para implementação na cloud
• Utilização process.env["VARIABLE_NAME"] para aceder a valores

Problemas de registo:

• Use context.log() em vez de console.log() para registos específicos de função
• Verifique se a cadeia de ligação do Application Insights está configurada
• Verifique os níveis de registo em host.json para filtrar

Obtenha ajuda da Microsoft

Pode obter mais ajuda da Microsoft de uma das seguintes formas:

• Pesquise os problemas conhecidos no repositório Funções do Azure Node.js. Se não vires o teu problema mencionado, cria um novo e diz-nos o que aconteceu.
• Se não conseguir diagnosticar o seu problema com este guia, os engenheiros de suporte da Microsoft estão disponíveis para ajudar a diagnosticar problemas na sua aplicação. A Microsoft oferece vários planos de suporte. Crie um ticket de suporte na secção de Suporte + resolução de problemas da página da sua aplicação de funções no portal Azure.

Passos seguintes

• Página de Perguntas e Respostas da Microsoft para Funções do Azure
• Guia do desenvolvedor de Funções do Azure Node.js