Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Solución de problemas con las transformaciones de Java

La siguiente información puede ayudarle a solucionar problemas comunes al transformar aplicaciones Java con Amazon Q Developer.

¿Por qué Amazon Q no puede subir mi proyecto?

Si su proyecto no se puede cargar, es probable que se deba a uno de los siguientes problemas. Consulte el tema correspondiente al error que vea en Amazon Q.

Reducción del tamaño del proyecto

Para transformar el código, Amazon Q genera un artefacto del proyecto, que incluye el código de origen, las dependencias del proyecto y los registros de compilación. El tamaño máximo del artefacto del proyecto para un trabajo de transformación es de 2 GB. Si recibe un error relacionado con el tamaño del artefacto del proyecto, debe reducir el tamaño del proyecto o intentar transformar un proyecto más pequeño. Puede ver el tamaño del archivo del artefacto del proyecto en los registros de transformación de código. Para obtener más información, consulte ¿Cómo puedo acceder a los registros de transformación del código?

Configuración de los ajustes del proxy en su IDE

Para transformar el código, Amazon Q carga el artefacto del proyecto en un bucket de Amazon S3 propiedad del servicio. Parte del proceso de carga implica el uso de certificados SSL o TLS para establecer la comunicación entre Amazon S3 y su IDE. Si utiliza un servidor proxy, los certificados SSL o TLS utilizados por el servidor proxy deben ser de confianza; de lo contrario, Amazon Q no podrá cargar el proyecto.

Si recibe un error relacionado con su proxy o los certificados, probablemente necesite configurar su IDE o sistema operativo para que confíe en sus certificados o actualizar otros ajustes del proxy.

Configuración de los certificados en JetBrains

Configuración de certificados en Visual Studio Code

Para configurar Visual Studio Code de forma que confíe en los certificados SSL o TLS utilizados por el servidor proxy, asegúrese de haber configurado los siguientes ajustes de proxy para su sistema operativo.

Permiso para acceder a Amazon S3

Durante una transformación, Amazon Q carga el código en un bucket de Amazon S3 propiedad del servicio. Si su red u organización no ha configurado el acceso a Amazon S3, Amazon Q no podrá cargar el proyecto.

Para garantizar que Amazon Q pueda cargar el proyecto, asegúrese de que la configuración del proxy y otros componentes de la red, como las políticas de prevención de pérdida de datos (DLP), estén configurados para permitir el acceso a Amazon S3. Es posible que también deba incluir en la lista de permitidos el bucket de Amazon S3 donde Amazon Q carga el proyecto. Para obtener más información, consulte Bucket de Amazon S3 URLs y ARNs a la lista de permitidos.

Si transforma un proyecto grande, las políticas de DLP u otros componentes de la red podrían provocar demoras e impedir que la carga se realice correctamente si no están configurados para incluir en la lista de permitidos el bucket de Amazon S3. Si decide no incluir el bucket en la lista, es posible que tenga que transformar un proyecto más pequeño para que Amazon Q pueda subirlo.

¿Por qué fallan mis comandos Maven?

A continuación, se Maven muestran algunos problemas de configuración que puede que veas en el archivo y. JetBrains Visual Studio Code IDEs Si soluciona los problemas y sigue viendo errores de Maven, es posible que haya un problema con su proyecto. Utilice la información de los registros de errores para solucionar cualquier problema del proyecto y, a continuación, intente volver a transformar el proyecto.

Actualización de la configuración de Maven en JetBrains

Si se produce un error de transformación en JetBrains debido a problemas con los comandos de Maven, los registros de errores aparecen en la pestaña Ejecutar. Utilice la información de los registros para solucionar el problema. A continuación, se muestran algunos problemas que puede que tenga que abordar:

Actualización de la configuración de Maven en Visual Studio Code

Si se produce un error en una transformación en VS Code debido a problemas con los comandos Maven, se abre un archivo de texto que contiene los registros de errores en una pestaña nueva. Utilice la información de los registros para solucionar el problema.

Asegúrese de haber configurado una de las siguientes opciones:

Para obtener más información, consulte ¿Cómo agrego Maven a mi PATH?

¿Cómo agrego Maven a mi PATH?

Para transformar su código en VS Code sin usar un contenedor Maven, debe instalar Maven y agregarlo a su variable de PATH.

Para comprobar si ya ha instalado Maven correctamente, ejecútelo mvn -v en un nuevo terminal de sistema operativo externo a Visual Studio Code. Debería ver un resultado con su versión de Maven.

Si obtiene un resultado en su terminal Visual Studio Code pero no en el terminal del sistema operativo, o si no encuentra el comando, tendrá que agregar Maven a su PATH.

Para añadir Maven a su PATH, siga las instrucciones de su máquina.

macOS

Para añadir Maven a su PATH de macOS, siga estos pasos.

1. Busque el directorio de instalación de Maven o la carpeta en la que instaló Maven y guarde la ruta a esa carpeta.

2. Abra el archivo de configuración del intérprete de comandos en el editor que prefiera. Para las versiones recientes de macOS, el intérprete de comandos predeterminado es zsh y el archivo de configuración predeterminado se encuentra en ~/.zshrc.

   Agregue las siguientes líneas en la parte inferior del archivo de configuración. Defina el valor de M2_HOME a la ruta que guardó en el paso 1:

   export M2_HOME="your Maven installation directory"
   export PATH="${M2_HOME}/bin:${PATH}"

   Estos comandos hacen que el comando mvn esté disponible en todos los terminales.

3. Cierre todas las ventanas de los terminales del sistema operativo y cierre todas las instancias de Visual Studio Code.

4. Para comprobar que Maven se ha añadido a su PATH, abra un nuevo terminal de sistema operativo y ejecute el siguiente comando:

   mvn -v

   Debería ver un resultado con su versión de Maven.

5. Después de ver el resultado de Maven, reinicie Visual Studio Code. Es posible que también deba reiniciar el equipo. Abra un nuevo terminal de Visual Studio Code y ejecute el siguiente comando:

   mvn -v

   El resultado debe ser idéntico al del paso 4. Si el resultado de Visual Studio Code es diferente, intente lo siguiente para asegurarse de que la configuración es correcta:

   • Compruebe la variable de PATH en Visual Studio Code. Es posible que una extensión IDE esté alterando el PATH de tal manera que se diferencie de la variable PATH local. Desinstale la extensión para eliminarla de su PATH.

   • Compruebe el intérprete de comandos predeterminado en Visual Studio Code. Si está configurado de otra manera que no sea zsh, repita estos pasos para el intérprete de comandos.

Windows

Para agregar Maven a su PATH de Windows, siga estos pasos:

1. Busque el directorio de instalación de Maven o la carpeta en la que instaló Maven y guarde la ruta a esa carpeta.

2. Abra la ventana Variables de entorno:

   1. Elija el botón Windows para abrir la barra de búsqueda.

   2. Introduzca Edit environment variables for your account y elíjalo.

3. En la ventana Variables de entorno, busque la variable de ruta. Si ya tiene una variable de ruta, elija Editar... para actualizarla. Si no ve ninguna variable de ruta, elija Nueva... para añadir una.

4. En la ventana Editar variable de entorno que aparece, haga doble clic en la ruta existente para editarla o seleccione Nueva para agregar una nueva entrada de ruta.

   Sustituya la entrada de ruta de Maven existente por la ruta que guardó en el paso 1 o añada la ruta como una nueva entrada. Al final de la ruta, añada \bin como sufijo, como en el siguiente ejemplo:

   C:\Users\yourusername\Downloads\apache-maven-3.9.6-bin\apache-maven-3.9.6\bin

5. Pulse Aceptar para guardar la entrada de la ruta y, a continuación, vuelva a elegir Aceptar en la ventana Variables de entorno.

6. Abra un nuevo símbolo del sistema y ejecute el siguiente comando:

   mvn -v

   Debería ver un resultado con su versión de Maven.

¿Por qué Amazon Q no puede compilar mi código?

Si la transformación falla cuando Amazon Q está compilando el código, es posible que el proyecto no esté configurado correctamente para el entorno en el que Amazon Q compila el código. Es posible que necesite actualizar la configuración de compilación o la implementación del código.

Revise el resultado del registro de compilación que proporciona Amazon Q para determinar si hay cambios que pueda realizar en su proyecto. A continuación, se muestran algunos problemas comunes que pueden impedir que Amazon Q compile el código.

Eliminación de las rutas absolutas en pom.xml

Si tiene una ruta absoluta en el archivo pom.xml, Amazon Q no podrá encontrar los archivos relevantes y, por consiguiente, es posible que no pueda compilar el código.

A continuación se muestra un ejemplo de una ruta absoluta que podría tener en su archivo pom.xml:

<toolspath>
    <path>/Library/Java/JavaVirtualMachines/jdk-11.0.11.jdk/Contents/Home/lib/tools.jar</path>
</toolspath>

En lugar de utilizar una ruta absoluta, puede crear una ruta relativa con un puntero. A continuación se muestra un ejemplo de cómo puede sustituir la ruta absoluta anterior por una ruta relativa:

<toolspath>
    <path>${java.home}/../lib/tools.jar</path>
</toolspath>

Eliminación de las bases de datos locales o externas en las pruebas unitarias

Amazon Q ejecuta todas las pruebas unitarias del proyecto cuando compila el código. Si una prueba unitaria llama a una base de datos local o externa, Amazon Q no tendrá acceso a la base de datos, lo que provocará un error en la compilación. Para evitar que la compilación falle, debe eliminar la llamada a la base de datos de la prueba unitaria o eliminar la prueba unitaria antes de enviar la transformación.

¿Por qué ha fallado mi transformación después de 55 minutos?

Si el trabajo de transformación de código falla después de 55 minutos, es probable que el tiempo de compilación del código supere el límite de tiempo de compilación. Actualmente, existe un límite de tiempo de 55 minutos para compilar el código.

Si el tiempo de compilación local es de 55 minutos o más, reduzca el tiempo de compilación del proyecto para transformar el código. Si la compilación local es más rápida que la compilación con Transformación de código, revise el proyecto para ver si hay tareas que puedan estar fallando o que requieran más tiempo en un entorno diferente. Plantéese la posibilidad de deshabilitar los casos de prueba de larga duración. Plantéese también la posibilidad de utilizar los tiempos de espera para intentar acceder a recursos que podrían no estar disponibles en el entorno IDE seguro o en Internet.

¿Por qué no puedo descargar el código transformado?

Si no puede descargar el código una vez completada la transformación, es probable que se deba a uno de los siguientes problemas. Consulte el tema correspondiente al error que vea en Amazon Q.

Reducción del tamaño del proyecto

Una vez completada la transformación, Amazon Q genera un artefacto de salida que contiene una diferencia con el código actualizado y un resumen de la transformación con información sobre los cambios realizados. El artefacto de salida debe tener 1 GB o menos para que el IDE lo descargue.

Si el artefacto de salida supera el límite, no podrá descargar el código actualizado o el resumen de la transformación. Intente transformar un proyecto más pequeño para evitar que se produzca un artefacto de gran tamaño. Si el problema persiste, ponte en contacto con Soporte. Para obtener información sobre cómo ponerse en contacto Soporte con Amazon Q, consulteUso de Amazon Q Developer para chatear con Soporte.

Descargue el código diff en un plazo de 30 días

El archivo de diferencias de códigos con el código actualizado solo estará disponible durante 30 días después de que se complete la transformación. Si han pasado más de 30 días desde que se completó la transformación, reiníciala para descargar el archivo diff.

Configuración de los ajustes del proxy en su IDE

Amazon Q descarga el código actualizado de un bucket de Amazon S3 propiedad del servicio. Parte del proceso de descarga implica el uso de certificados SSL o TLS para establecer la comunicación entre Amazon S3 y su IDE. Si utiliza un servidor proxy, los certificados SSL o TLS utilizados por el servidor proxy deben ser de confianza; de lo contrario, Amazon Q no podrá cargar el proyecto.

Para descargar el código, puede que tenga que configurar el IDE para que confíe en los certificados o actualizar otras configuraciones del proxy. Para obtener más información sobre la actualización de la configuración del proxy, consulte Configuración de los ajustes del proxy en su IDE.

Eliminación de los caracteres comodín de la configuración del proxy de JetBrains

Si ha configurado los ajustes de proxy en su IDE de JetBrains, es posible que aparezca el siguiente error al descargar el código actualizado:

software.amazon.awssdk.core.exception.SdkClientException: 
Unable to execute HTTP request: Dangling meta character '*' near index 0

Es probable que esto se deba a la presencia de un carácter comodín (*) en el campo No hay proxy para de la configuración del proxy del IDE. El SDK de Java que utiliza Amazon Q no admite entradas comodín en este campo.

Para descargar el código, elimine los caracteres comodín del campo No hay proxy para y, a continuación, reinicie el IDE. Si necesita especificar los hosts que debe omitir el proxy, utilice una expresión regular en lugar de un comodín. Para actualizar la configuración del proxy en su JetBrains IDE, consulte el proxy HTTP en la JetBrains documentación.

¿Cómo puedo acceder a los registros de transformación del código?

Acceso a registros en JetBrains

Para obtener información sobre cómo acceder a los archivos de registro de JetBrains, consulte Locating IDE log files en la documentación de JetBrains.

Para encontrar los registros emitidos por Amazon QJetBrains, busque la siguiente cadena en los registros del IDE:

software.aws.toolkits.jetbrains.services.codemodernizer

Los registros de transformación de código comienzan con la cadena anterior. Los registros generados por Maven se muestran en la pestaña Ejecutar y tienen la cadena anterior antes y después de la entrada del registro.

Acceso a registros en Visual Studio Code

Para buscar los registros emitidos por Amazon Q enVS Code, complete los siguientes pasos:

Los registros de transformación en VS Code llevan el prefijo CodeTransformation:. A continuación se muestra un ejemplo de un registro generado en VS Code por un error de dependencias de copia de Maven:

2024-02-12 11:29:16 [ERROR]: CodeTransformation: Error in running Maven copy-dependencies command mvn = /bin/sh: mvn: command not found

¿Cómo puedo encontrar mi ID de trabajo de transformación?

Localización del ID de trabajo en JetBrains

Para encontrar el ID de un trabajo de transformación en JetBrains, vaya a la pestaña Detalles de la transformación en el Centro de transformación y elija el icono Mostrar estado del trabajo (reloj).

Localización del ID de trabajo en Visual Studio Code

Para encontrar el ID de un trabajo de transformación en VS Code, vaya al Centro de transformación y elija el icono Mostrar estado del trabajo (reloj).