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

Você está lendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X. info

ResourceDoesNotExist

Mensagem de erro

A implantação do proxy de API pela interface do Edge ou pela API de gerenciamento do Edge 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> da política JavaCallout não existir no nível do proxy de API, do ambiente ou da organização, 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 foi enviado 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 de API para conferir todos os recursos enviados por upload no nível do proxy de API. Neste exemplo, o proxy de 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 estará 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 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 de API, do ambiente ou da organização. Para mais informações, consulte Arquivos de recursos.

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

NoResourceForURL

Mensagem de erro

A implantação do proxy de API pela interface do Edge ou pela API de gerenciamento do Edge 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 de proxy de API, ambiente ou organização.

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 recurso foi enviado 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 por upload no nível do proxy de 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 estará 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 de API, da organização ou do ambiente, exclua o recurso e faça o upload novamente, conforme descrito na etapa 2. Caso contrário, pule para a etapa 3.

  2. Para excluir o recurso no nível do 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 recursos 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 ambiente).

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

JavaCalloutInstantiationFailed

Mensagem de erro

A implantação do proxy de API pela interface do Edge ou pela API de gerenciamento do Edge 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 O arquivo JAR que contém a classe Java identificada no erro não é carregado.
Arquivo JAR corrompido O arquivo JAR que contém a classe Java identificada no erro está 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 parcialmente enviado, recrie o JAR e faça o upload dele no nível apropriado (proxy de API, organização ou 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 o 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 JavaCallout, haverá um problema com o código Java ou a classe dependente que está causando esse erro. a. Se você for um usuário da nuvem pública, entre em contato com o suporte da Apigee. b. Se você usa a nuvem privada, vá para Causa: problema no código Java.

Resolução

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

Causa: problema no código Java

Etapas de diagnóstico apenas para usuários do Private Cloud

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. Você pode encontrar 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 aponta para algum problema no seu código Java.

Resolução

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

Fazer upload do arquivo JAR

Verifique se o elemento de recurso com todas as classes necessárias existe 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"