Solução de problemas de erro no ambiente de execução da política JavaCallout

Você está vendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X. informações

ResourceDoesNotExist

Mensagem de erro

A implantação do proxy de API pela IU do Edge ou pela API Edge Management falha com esta mensagem de erro:

Error Deploying Revision <var>revision_number</var> to <var>environment</var>
Resource with name <var>ResourceURL</var> and type java does not exist.

Exemplo de mensagem de erro

Error Deploying Revision 1 to test
Resource with name myresource.jar and type java does not exist.

Captura de tela com erro de exemplo

Causa

Se o recurso especificado no elemento <ResourceURL> na política Java callout não existir no nível do proxy, do ambiente ou da organização de API, a implantação do proxy de API vai falhar.

Diagnóstico

1. Identifique o ambiente e o nome do recurso. Você encontra essas informações na mensagem de erro. Por exemplo, no erro a seguir, o ambiente é test e o nome do recurso usado no elemento <ResourceURL> é myresource.jar.

   Error Deploying Revision 1 to test
   Resource with name myresource.jar and type java does not exist.
   

2. Determine a política JavaCallout que está usando o recurso identificado na etapa 1 acima.

   Por exemplo, a política a seguir especifica o valor de <ResourceURL> como myresource.jar, que corresponde ao valor na mensagem de erro:

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <JavaCallout name="hello-java">
       <ClassName>com.apigeesample.HelloJava</ClassName>
       <ResourceURL>java://myresource.jar</ResourceURL>
   </JavaCallout>
   

3. Determine se o recurso faz parte do proxy de API com falha ou se o upload está sendo feito no nível do ambiente ou da organização. Caso contrário, essa é a causa do erro.

   • Acesse a guia Recursos no painel Navegador do editor de proxy da API para ver todos os recursos enviados no nível de proxy da API. Neste exemplo, o proxy da API não tem recursos enviados.

     

   • Os recursos podem estar disponíveis no nível do ambiente ou da organização. Para mais informações, consulte Arquivos de recursos.

     • Para determinar se o recurso existe no nível do ambiente, emita a seguinte chamada de API usando curl: curl -v -u <strong>email </strong>"https://api.enterprise.apigee.com/v1/organizations/myorg/environments/myenv/resourcefiles/java/myresource.jar"

     • Para determinar se o recurso existe no nível da organização, emita a seguinte chamada de API usando curl, omitindo os detalhes do ambiente: curl -v -u email "https://api.enterprise.apigee.com/v1/organizations/myorg/resourcefiles/java/myresource.jar"

     Se você receber um código de status 404 como resposta para essas APIs, o recurso está ausente nos níveis da organização e do ambiente.

   Se o recurso não estiver disponível no proxy de API, na organização e no nível do ambiente, o erro de implantação será retornado:

   Resource with name myresource.jar and type java does not exist.
    ```
   

Resolução

Verifique se o recurso especificado no elemento <ResourceURL> existe no nível do proxy, ambiente ou organização da API. Para mais informações, consulte Arquivos de recursos.

Para corrigir o exemplo de política Java callout mostrado acima, faça upload do arquivo JAR no nível apropriado (proxy de API, organização ou nível de ambiente).

NoResourceForURL

Mensagem de erro

A implantação do proxy de API pela IU do Edge ou pela API Edge Management falha com esta mensagem de erro:

Error in deployment for environment <var>environment</var>
The revision is deployed, but traffic cannot flow. Could not locate a resource with URL <var>ResourceURL</var>

Exemplo de mensagem de erro

Error in deployment for environment test
The revision is deployed, but traffic cannot flow. Could not locate a resource with URL java://myresource.jar

Captura de tela com erro de exemplo

Causa

Esse erro pode ocorrer se o arquivo de recurso estiver corrompido ou parcialmente enviado, mesmo que pareça existir no nível do proxy, do ambiente ou da organização da API.

Diagnóstico

1. Identifique o ambiente e o nome do recurso. Você encontra essas informações na mensagem de erro. Por exemplo, no erro a seguir, o nome do ambiente é test e o nome do recurso usado no elemento <ResourceURL> é myresource.jar.

   Error in deployment for environment test
   The revision is deployed, but traffic cannot flow. Could not locate a resource with URL java://myresource.jar
   

2. Verifique se o upload do recurso foi feito no nível do proxy de API, do ambiente ou da organização. No exemplo abaixo, é possível ver que o recurso myresource.jar é enviado para o nível do proxy da API.

   

   Os recursos podem estar disponíveis no nível do ambiente ou da organização. Para mais informações, consulte Arquivos de recursos.

   Para determinar se o recurso existe no nível do ambiente, emita a seguinte chamada de API usando curl: curl -v -u <strong>email </strong>"https://api.enterprise.apigee.com/v1/organizations/myorg/environments/myenv/resourcefiles/java/myresource.jar"

   Para determinar se o recurso existe no nível da organização, emita a seguinte chamada de API usando curl, omitindo os detalhes do ambiente: curl -v -u email "https://api.enterprise.apigee.com/v1/organizations/myorg/resourcefiles/java/myresource.jar"

   Se você receber um código de status 404 como resposta para essas APIs, o recurso está ausente nos níveis da organização e do ambiente.

Resolução

1. Se você determinar que o recurso existe no nível do proxy, da organização ou do ambiente de API, exclua o recurso e faça um novo upload, conforme descrito na etapa 2. Caso contrário, pule para o próximo item.

2. Para excluir o recurso no nível proxy de API, navegue até a guia Recursos no painel Navegador do editor de proxy de API e clique no botão “X” ao lado do recurso, conforme mostrado abaixo.

   

   Para excluir um recurso no nível do ambiente ou da organização, use o verbo DELETE nas chamadas de API usadas anteriormente nas etapas de diagnóstico. Por exemplo, para excluir o recurso no nível do ambiente, digite o seguinte comando: curl -X DELETE -v -u <strong>email </strong>"https://api.enterprise.apigee.com/v1/organizations/myorg/environments/myenv/resourcefiles/java/myresource.jar"

3. Faça upload do arquivo JAR no nível apropriado (proxy de API, organização ou nível de ambiente).

4. Se o novo upload do recurso não ajudar, será necessário reiniciar os processadores de mensagens afetados. Se você estiver usando o Apigee Edge no Cloud, entre em contato com o suporte da Apigee. Se você for um usuário de nuvem privada, consulte Como iniciar, interromper, reiniciar e verificar o status do Apigee Edge.

JavaCalloutInstantiationFailed

Mensagem de erro

A implantação do proxy de API pela IU do Edge ou pela API Edge Management falha com esta mensagem de erro:

Error in deployment for environment <var>environment</var>
The revision is deployed, but traffic cannot flow. Failed to instantiate the JavaCallout Class <var>class_name</var>

Ou

Error in deployment for environment <var>environment</var>.
The revision is deployed and traffic can flow, but flow may be impaired. Failed to instantiate the JavaCallout Class <var>class_name</var>

Exemplo de mensagem de erro

Error in deployment for environment test
The revision is deployed, but traffic cannot flow. Failed to instantiate the JavaCallout Class my.class

Captura de tela com erro de exemplo

Causa

Estas são as causas comuns desse erro

Causa	Descrição
Arquivo JAR ausente	Não foi feito o upload do arquivo JAR que contém a classe Java identificada no erro.
Arquivo JAR corrompido	O arquivo JAR que contém a classe Java identificada no erro foi corrompido/parcialmente enviado.
Arquivo de turma ausente	O arquivo de classe Java identificado no erro não faz parte do arquivo JAR especificado em >ResourceURL<.
Problema no código Java	Há um erro no código, como um construtor ausente, um problema de dependência de código ou outro problema.

Etapa comum de diagnóstico

1. Identifique o nome do ambiente e a classe que não foi importada. Por exemplo, o nome de ambiente da mensagem de erro a seguir é test e o nome da classe é my.class:

   Error in deployment for environment test
   The revision is deployed, but traffic cannot flow. Failed to instantiate the JavaCallout Class my.class
   
   

   Causa: arquivo JAR ausente

Diagnóstico

1. Determine o arquivo JAR que deve conter a classe (identificada na etapa 1 acima) e não pôde ser instanciado.
2. Verifique se o arquivo JAR específico foi enviado no nível do proxy de API, da organização ou do ambiente. Se o arquivo JAR não tiver sido enviado para nenhum dos níveis, vá para "Resolução".
3. Se o arquivo JAR for carregado, vá para Causa: arquivo JAR corrompido.

Resolução

1. Se o arquivo JAR estiver corrompido ou tiver sido parcialmente enviado, recrie o arquivo e faça upload do arquivo no nível apropriado (proxy de API, organização ou nível de ambiente).
2. Reimplantar o proxy da API.

Causa: arquivo JAR corrompido

Diagnóstico

1. Determine o arquivo JAR que deve conter a classe (identificada na etapa 1 acima), que não pôde ser instanciada.
2. Verifique se o arquivo JAR específico está corrompido. Por exemplo, se não for possível descompor o arquivo porque ele está corrompido ou parcialmente foi enviado. Se ele estiver corrompido, acesse "Resolução".
3. Se o arquivo JAR não estiver corrompido, vá para Causa: arquivo de classe ausente.

Resolução

1. Recrie os arquivos JAR corrompidos e faça upload deles no nível apropriado (proxy de API, organização ou ambiente).
2. Reimplantar o proxy da API.

Causa: arquivo de classe ausente

Diagnóstico

1. Verifique se o arquivo de classe Java específico (identificado na etapa 1 acima) faz parte do arquivo JAR especificado em >ResourceURL< ou de qualquer arquivo JAR dependente.
2. Se o arquivo de classe não existir em nenhum dos arquivos JAR, você determinou a causa do erro. Vá para "Resolução".
3. Se o arquivo de classe existir em um dos arquivos JAR especificados na política JavaCaption, será necessário que haja um problema com o código Java ou com a classe dependente que esteja levando a esse erro. a. Se você for um usuário de nuvem pública, entre em contato com o suporte da Apigee. b. Se você é um usuário de nuvem privada, siga para Causa: problema de código Java.

Resolução

1. Recrie o JAR com os arquivos de classe ausentes e faça upload do arquivo JAR no nível apropriado (proxy de API, organização ou nível de ambiente).
2. Reimplantar o proxy da API.

Causa: problema no código Java

Etapas de diagnóstico somente para usuários da nuvem privada

Diagnóstico

1. Verifique os registros do processador de mensagens (/opt/apigee/var/log/edge-message-processor/system.log e /opt/apigee/var/log/edge-message-processor/configurations.log).

2. Talvez você veja uma exceção semelhante ao exemplo abaixo:

   2019-07-05 05:40:13,240 org:myorg env:staging target:/organizations/myorg/apiproxies/MyAPI/revisions/5 action:add context-id: mode: Apigee-Main-53 ERROR CONFIG-CHANGE - AbstractConfigurator.add() : Add null to Step failed, reason: {}
   com.apigee.kernel.exceptions.spi.UncheckedException: Failed to instantiate the JavaCallout Class <class name>
   at com.apigee.steps.javacallout.JavaCalloutStepDefinition.newInstance(JavaCalloutStepDefinition.java:116)
   at com.apigee.messaging.runtime.StepDefinition.getStepDefinitionExecution(StepDefinition.java:218)
   …<snipped>
   Caused by: java.lang.reflect.InvocationTargetException: null
   at sun.reflect.NativeConstructorAccessorImpl.newInstance0(Native Method)
   at sun.reflect.NativeConstructorAccessorImpl.newInstance(NativeConstructorAccessorImpl.java:62)
   at com.apigee.steps.javacallout.JavaCalloutStepDefinition.access$100(JavaCalloutStepDefinition.java:41)
   at com.apigee.steps.javacallout.JavaCalloutStepDefinition$CallOutWrapper.initialize(JavaCalloutStepDefinition.java:131)
   at com.apigee.steps.javacallout.JavaCalloutStepDefinition$CallOutWrapper.<init>(JavaCalloutStepDefinition.java:126)
   ... 42 common frames omitted
   Caused by: <Reason>
   
   ...<snipped>
   
   

3. Leia a exceção com atenção para entender o motivo da falha. Normalmente, isso pode indicar algum problema no seu código Java.

Resolução

1. Dependendo da causa da falha, pode ser necessário corrigir o problema no seu código Java.
2. Recrie o JAR com os arquivos de classe ausentes e faça upload do arquivo JAR no nível apropriado (proxy de API, organização ou nível de ambiente).
3. Reimplantar o proxy da API.

Fazer upload do arquivo JAR

Verifique se o elemento de recurso com todas as classes necessárias existem no nível do proxy de API, do ambiente ou da organização. Para mais informações, consulte Arquivos de recursos.

1. Para fazer upload de um recurso no nível do proxy da API, clique em + (sinal de adição) na guia "Recursos", selecione Importar arquivo e faça o upload do arquivo na sua máquina local. O nome de arquivo precisa corresponder ao elemento >ResourceURL<, mas sem o prefixo java://.

   

2. Se quiser que um recurso esteja disponível para mais de um proxy de API no mesmo ambiente, faça upload do recurso no ambiente. Você precisará usar a API Edge, conforme descrito em Arquivos de recursos.

   Por exemplo, insira a seguinte chamada de API da máquina local para fazer upload do arquivo especificado no nível do ambiente:

   curl -v -u email -H "Content-Type: application/octet-stream" \
   -X POST --data-binary @{classes.jar} \
   "http://{mgmt_server}:{port}/v1/organizations/myorg/environments/myenv/resourcefiles?name=myresouce.jar&type=java"
   

   Emita a chamada de API no mesmo diretório do arquivo.

3. Para disponibilizar o arquivo para todos os proxies de API em todos os ambientes da organização, você pode omitir os detalhes do ambiente no caminho base. Exemplo:

   curl -v -u email -H "Content-Type: application/octet-stream" \
   -X POST --data-binary @{classes.jar} \
   "http://{mgmt_server}:{port}/v1/organizations/myorg/resourcefiles?name=myresouce.jar&type=java"