Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Behebung von Problemen mit Java-Transformationen

Die folgenden Informationen können Ihnen helfen, häufig auftretende Probleme bei der Transformation von Java-Anwendungen mit Amazon Q Developer zu beheben.

Warum kann Amazon Q mein Projekt nicht hochladen?

Wenn Ihr Projekt nicht hochgeladen werden kann, liegt das wahrscheinlich an einem der folgenden Probleme. Lesen Sie das Thema, das dem Fehler entspricht, den Sie in Amazon Q sehen.

Reduzieren Sie die Projektgröße

Um Ihren Code zu transformieren, generiert Amazon Q ein Projektartefakt, das Ihren Quellcode, Projektabhängigkeiten und Build-Logs enthält. Die maximale Größe des Projektartefakts für einen Transformationsauftrag beträgt 2 GB. Wenn Sie im Zusammenhang mit der Größe des Projektartefakts eine Fehlermeldung erhalten, müssen Sie die Größe Ihres Projekts verringern oder versuchen, ein kleineres Projekt zu transformieren. Sie können die Größe Ihrer Projektartefaktdatei in den Codetransformationsprotokollen einsehen. Weitere Informationen finden Sie unter Wie greife ich auf die Codetransformationsprotokolle zu?.

Konfigurieren Sie die Proxyeinstellungen in Ihrer IDE

Um Ihren Code zu transformieren, lädt Amazon Q Ihr Projektartefakt in einen serviceeigenen Amazon S3 S3-Bucket hoch. Ein Teil des Upload-Vorgangs beinhaltet die Verwendung von SSL- oder TLS-Zertifikaten, um die Kommunikation zwischen Amazon S3 und Ihrer IDE herzustellen. Wenn Sie einen Proxy-Server verwenden, müssen die von Ihrem Proxy-Server verwendeten SSL- oder TLS-Zertifikate vertrauenswürdig sein, andernfalls kann Amazon Q Ihr Projekt nicht hochladen.

Wenn Sie einen Fehler im Zusammenhang mit Ihrem Proxy oder Ihren Zertifikaten erhalten, müssen Sie wahrscheinlich Ihre IDE oder Ihr Betriebssystem so konfigurieren, dass es Ihren Zertifikaten vertraut, oder andere Proxyeinstellungen aktualisieren.

Konfigurieren Sie Zertifikate in JetBrains

Konfigurieren Sie Zertifikate in Visual Studio Code

Um die Konfiguration so Visual Studio Code zu konfigurieren, dass sie den von Ihrem Proxyserver verwendeten SSL- oder TLS-Zertifikaten vertrauen, stellen Sie sicher, dass Sie die folgenden Proxyeinstellungen für Ihr Betriebssystem konfiguriert haben.

Zugriff auf Amazon S3 zulassen

Während einer Transformation lädt Amazon Q Ihren Code in einen serviceeigenen Amazon S3 S3-Bucket hoch. Wenn Ihr Netzwerk oder Ihre Organisation den Zugriff auf Amazon S3 nicht konfiguriert hat, kann Amazon Q Ihr Projekt nicht hochladen.

Um sicherzustellen, dass Amazon Q Ihr Projekt hochladen kann, stellen Sie sicher, dass Ihre Proxy-Konfiguration und andere Netzwerkkomponenten, wie Data Lost Prevention (DLP) -Richtlinien, so konfiguriert sind, dass sie den Zugriff auf Amazon S3 ermöglichen. Möglicherweise müssen Sie auch den Amazon S3 S3-Bucket zulassen, in den Amazon Q Ihr Projekt hochlädt. Weitere Informationen finden Sie unter Amazon S3 S3-Bucket URLs und ARNs zur Allowlist.

Wenn Sie ein großes Projekt transformieren, können DLP-Richtlinien oder andere Netzwerkkomponenten zu Verzögerungen führen und einen erfolgreichen Upload verhindern, wenn sie nicht so konfiguriert sind, dass sie den Amazon S3 S3-Bucket zulassen. Wenn Sie den Bucket nicht auf die Zulassungsliste setzen möchten, müssen Sie möglicherweise ein kleineres Projekt transformieren, damit Amazon Q es hochladen kann.

Warum schlagen meine Maven Befehle fehl?

Im Folgenden sind Maven Konfigurationsprobleme aufgeführt, die möglicherweise im JetBrains und auftreten Visual Studio Code IDEs. Wenn Sie die Probleme beheben und weiterhin Maven Fehler sehen, liegt möglicherweise ein Problem mit Ihrem Projekt vor. Verwenden Sie die Informationen in den Fehlerprotokollen, um alle Probleme mit Ihrem Projekt zu beheben, und versuchen Sie dann erneut, Ihr Projekt zu transformieren.

Aktualisieren Sie die Maven Konfiguration in JetBrains

Wenn eine Transformation JetBrains aufgrund von Maven Befehlsproblemen fehlschlägt, werden die Fehlerprotokolle auf der Registerkarte Ausführen angezeigt. Verwenden Sie die Informationen in den Protokollen, um das Problem zu beheben. Im Folgenden sind einige Probleme aufgeführt, die Sie möglicherweise beheben müssen:

MavenKonfiguration aktualisieren in Visual Studio Code

Wenn eine Transformation VS Code aufgrund von Maven Befehlsproblemen fehlschlägt, wird eine Textdatei mit den Fehlerprotokollen auf einer neuen Registerkarte geöffnet. Verwenden Sie die Informationen in den Protokollen, um das Problem zu beheben.

Vergewissern Sie sich, dass Sie eine der folgenden Optionen konfiguriert haben:

Weitere Informationen finden Sie unter Wie füge ich Maven zu meinem hinzu? PATH.

Wie füge ich Maven zu meinem hinzu? PATH

Um Ihren Code VS Code ohne Verwendung eines Maven Wrappers umzuwandeln, müssen Sie ihn installieren Maven und zu Ihrer PATH Variablen hinzufügen.

Um zu überprüfen, ob Sie bereits korrekt Maven installiert haben, führen Sie es mvn -v in einem neuen Betriebssystem-Terminal außerhalb von ausVisual Studio Code. Sie sollten eine Ausgabe mit Ihrer Maven Version sehen.

Wenn Sie eine Ausgabe in Ihrem Visual Studio Code Terminal erhalten, aber nicht in Ihrem Betriebssystem-Terminal, oder wenn der Befehl nicht gefunden wird, müssen Sie Maven zu Ihrer hinzufügenPATH.

Um Maven zu Ihrem hinzuzufügenPATH, folgen Sie den Anweisungen für Ihr Gerät.

macOS

Führen Sie die folgenden Schritte ausPATH, Maven um es zu Ihrem macOS hinzuzufügen.

1. Suchen Sie Ihr Maven Installationsverzeichnis oder den Ordner, in dem Sie installiert habenMaven, und speichern Sie den Pfad zu diesem Ordner.

2. Öffnen Sie die Konfigurationsdatei für Ihre Shell in einem Editor Ihrer Wahl. Für aktuelle macOS-Versionen ist die Standard-Shell zsh und die Standardkonfigurationsdatei befindet sich unter~/.zshrc.

   Fügen Sie die folgenden Zeilen am Ende der Konfigurationsdatei hinzu. Stellen Sie den Wert von M2_HOME auf den Pfad ein, den Sie in Schritt 1 gespeichert haben:

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

   Diese Befehle machen den mvn Befehl in allen Terminals verfügbar.

3. Schließen Sie alle Betriebssystem-Terminalfenster und beenden Sie alle Visual Studio Code Instanzen.

4. Um zu überprüfen, ob es zu Ihrem hinzugefügt Maven wurdePATH, öffnen Sie ein neues Betriebssystem-Terminal und führen Sie den folgenden Befehl aus:

   mvn -v

   Sie sollten eine Ausgabe mit Ihrer Maven Version sehen.

5. Nachdem Sie Ihre Maven Ausgabe gesehen haben, starten Sie neuVisual Studio Code. Möglicherweise müssen Sie Ihren Computer auch neu starten. Öffnen Sie ein neues Visual Studio Code Terminal und führen Sie den folgenden Befehl aus:

   mvn -v

   Die Ausgabe sollte mit der Ausgabe in Schritt 4 identisch sein. Wenn die Visual Studio Code Ausgabe anders ist, versuchen Sie Folgendes, um sicherzustellen, dass Ihre Konfiguration korrekt ist:

   • Checken Sie Ihre PATH Variable einVisual Studio Code. Eine IDE-Erweiterung ändert sie möglicherweise PATH so, dass sie sich von Ihrer lokalen PATH Variablen unterscheidet. Deinstallieren Sie die Erweiterung, um sie von Ihrem PATH zu entfernen.

   • Checken Sie Ihre Standard-Shell einVisual Studio Code. Wenn sie auf etwas anderes als eingestellt istzsh, wiederholen Sie diese Schritte für Ihre Shell.

Windows

Führen Sie Maven die folgenden Schritte aus WindowsPATH, um Ihre zu erweitern:

1. Suchen Sie Ihr Maven Installationsverzeichnis oder den Ordner, in dem Sie installiert habenMaven, und speichern Sie den Pfad zu diesem Ordner.

2. Öffnen Sie das Fenster mit den Umgebungsvariablen:

   1. Wählen Sie die Windows Schaltfläche, um die Suchleiste zu öffnen.

   2. Geben Sie es ein Edit environment variables for your account und wählen Sie es aus.

3. Suchen Sie im Fenster mit den Umgebungsvariablen nach der Path-Variablen. Wenn Sie bereits eine Path-Variable haben, wählen Sie Bearbeiten... um sie zu aktualisieren. Wenn Sie keine Path-Variable sehen, wählen Sie Neu... um eine hinzuzufügen.

4. Doppelklicken Sie im daraufhin angezeigten Fenster Umgebungsvariable bearbeiten auf den vorhandenen Pfad, um ihn zu bearbeiten, oder wählen Sie Neu, um einen neuen Pfadeintrag hinzuzufügen.

   Ersetzen Sie den vorhandenen Maven Pfadeintrag durch den Pfad, den Sie in Schritt 1 gespeichert haben, oder fügen Sie den Pfad als neuen Eintrag hinzu. Fügen Sie \bin am Ende des Pfads ein Suffix hinzu, wie im folgenden Beispiel:

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

5. Wählen Sie OK, um den Pfadeintrag zu speichern, und klicken Sie dann im Fenster mit den Umgebungsvariablen erneut auf OK.

6. Öffnen Sie eine neue Befehlszeile und führen Sie den folgenden Befehl aus:

   mvn -v

   Sie sollten eine Ausgabe mit Ihrer Maven Version sehen.

Warum kann Amazon Q meinen Code nicht erstellen?

Wenn die Transformation fehlschlägt, während Amazon Q Ihren Code erstellt, ist Ihr Projekt möglicherweise nicht richtig für die Umgebung konfiguriert, in der Amazon Q Ihren Code erstellt. Möglicherweise müssen Sie Ihre Build-Konfiguration oder Code-Implementierung aktualisieren.

Prüfen Sie die Build-Log-Ausgabe, die Amazon Q bereitstellt, um festzustellen, ob es Änderungen gibt, die Sie an Ihrem Projekt vornehmen können. Im Folgenden sind einige häufig auftretende Probleme aufgeführt, die Amazon Q daran hindern könnten, Ihren Code zu erstellen.

Entfernen Sie absolute Pfade in pom.xml

Wenn Sie einen absoluten Pfad in Ihrer Datei pom.xml haben, kann Amazon Q die entsprechenden Dateien nicht finden und kann daher möglicherweise Ihren Code nicht erstellen.

Im Folgenden finden Sie ein Beispiel für einen absoluten Pfad, den Sie in Ihrer pom.xml Datei haben könnten:

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

Anstatt einen absoluten Pfad zu verwenden, können Sie mit einem Zeiger einen relativen Pfad erstellen. Im Folgenden finden Sie ein Beispiel dafür, wie Sie den vorherigen absoluten Pfad durch einen relativen Pfad ersetzen können:

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

Entfernen Sie lokale oder externe Datenbanken in Komponententests

Amazon Q führt alle Komponententests in Ihrem Projekt durch, wenn es Ihren Code erstellt. Wenn ein Komponententest eine lokale oder externe Datenbank aufruft, hat Amazon Q keinen Zugriff auf die Datenbank, sodass der Build fehlschlägt. Um zu verhindern, dass der Build fehlschlägt, müssen Sie entweder den Datenbankaufruf aus dem Komponententest entfernen oder den Komponententest entfernen, bevor Sie die Transformation abschicken.

Warum ist meine Transformation nach 55 Minuten fehlgeschlagen?

Wenn Ihr Codetransformationsjob nach 55 Minuten fehlschlägt, überschreitet Ihre Codeerstellungszeit wahrscheinlich das Build-Zeitlimit. Derzeit gibt es ein Zeitlimit von 55 Minuten für die Erstellung Ihres Codes.

Wenn Ihre lokale Build-Zeit 55 Minuten oder länger dauert, reduzieren Sie die Build-Zeit Ihres Projekts, um Ihren Code zu transformieren. Wenn Ihr lokaler Build schneller ist als der Build mit Code Transformation, überprüfen Sie Ihr Projekt auf Aufgaben, die in einer anderen Umgebung möglicherweise fehlschlagen oder länger dauern. Erwägen Sie, Testfälle mit langer Laufzeit zu deaktivieren. Erwägen Sie auch, Timeouts für Versuche zu verwenden, auf Ressourcen zuzugreifen, die in der sicheren IDE-Umgebung oder im Internet möglicherweise nicht verfügbar sind.

Warum kann ich meinen transformierten Code nicht herunterladen?

Wenn Sie Ihren Code nach Abschluss der Transformation nicht herunterladen können, liegt das wahrscheinlich an einem der folgenden Probleme. Lesen Sie das Thema, das dem Fehler entspricht, den Sie in Amazon Q sehen.

Reduzieren Sie die Projektgröße

Nach Abschluss der Transformation generiert Amazon Q ein Ausgabeartefakt, das einen Unterschied zu Ihrem aktualisierten Code und eine Transformationszusammenfassung mit Informationen zu den vorgenommenen Änderungen enthält. Das Ausgabeartefakt muss 1 GB oder weniger groß sein, damit die IDE es herunterladen kann.

Wenn das Ausgabeartefakt das Limit überschreitet, können Sie den aktualisierten Code oder die Zusammenfassung der Transformation nicht herunterladen. Versuchen Sie, ein kleineres Projekt zu transformieren, um zu verhindern, dass ein großes Ausgabeartefakt entsteht. Wenn das Problem weiterhin besteht, wenden Sie sich an. Support Informationen zur Kontaktaufnahme Support mit Amazon Q finden Sie unterVerwenden von Amazon Q Developer zum Chatten mit Support.

Laden Sie den Code Diff innerhalb von 30 Tagen herunter

Die Code-Diff-Datei mit Ihrem aktualisierten Code ist nach Abschluss der Transformation nur 30 Tage lang verfügbar. Wenn seit Abschluss der Transformation mehr als 30 Tage vergangen sind, starten Sie die Transformation neu, um die Diff-Datei herunterzuladen.

Konfigurieren Sie die Proxyeinstellungen in Ihrer IDE

Amazon Q lädt Ihren aktualisierten Code aus einem serviceeigenen Amazon S3 S3-Bucket herunter. Ein Teil des Download-Vorgangs beinhaltet die Verwendung von SSL- oder TLS-Zertifikaten, um die Kommunikation zwischen Amazon S3 und Ihrer IDE herzustellen. Wenn Sie einen Proxy-Server verwenden, müssen die von Ihrem Proxy-Server verwendeten SSL- oder TLS-Zertifikate vertrauenswürdig sein, andernfalls kann Amazon Q Ihr Projekt nicht hochladen.

Um Ihren Code herunterzuladen, müssen Sie möglicherweise Ihre IDE so konfigurieren, dass sie Zertifikaten vertraut, oder andere Proxyeinstellungen aktualisieren. Weitere Informationen zur Aktualisierung Ihrer Proxyeinstellungen finden Sie unterKonfigurieren Sie die Proxyeinstellungen in Ihrer IDE.

Entfernen Sie Platzhalterzeichen in den JetBrains Proxyeinstellungen

Wenn Sie die Proxyeinstellungen in Ihrer JetBrains IDE konfiguriert haben, wird beim Herunterladen Ihres aktualisierten Codes möglicherweise der folgende Fehler angezeigt:

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

Dies wird wahrscheinlich durch das Vorhandensein eines Platzhalterzeichens (*) im Feld Kein Proxy für in den Proxyeinstellungen Ihrer IDE verursacht. Das von Amazon Q verwendete Java-SDK unterstützt keine Platzhaltereinträge in diesem Feld.

Um Ihren Code herunterzuladen, entfernen Sie alle Platzhalter aus dem Feld Kein Proxy für und starten Sie dann Ihre IDE neu. Wenn Sie Hosts angeben müssen, die den Proxy umgehen sollen, verwenden Sie einen regulären Ausdruck anstelle eines Platzhalters. Informationen zum Aktualisieren der Proxyeinstellungen in Ihrer JetBrains IDE finden Sie in der JetBrains Dokumentation unter HTTP-Proxy.

Wie greife ich auf die Codetransformationsprotokolle zu?

Access meldet sich an JetBrains

Informationen zum Zugriff auf JetBrains Protokolldateien finden Sie in der JetBrains Dokumentation unter Suchen nach IDE-Protokolldateien.

Um von Amazon Q ausgegebene Protokolle in zu findenJetBrains, suchen Sie in den IDE-Protokollen nach der folgenden Zeichenfolge:

software.aws.toolkits.jetbrains.services.codemodernizer

Codetransformationsprotokolle beginnen mit der vorhergehenden Zeichenfolge. Von generierte Protokolle Maven werden auf der Registerkarte Ausführen angezeigt und enthalten die vorangegangene Zeichenfolge vor und nach dem Protokolleintrag.

Access meldet sich an Visual Studio Code

Gehen Sie wie folgt vorVS Code, um von Amazon Q ausgegebene Protokolle in zu finden:

Logs zur Codetransformation VS Code haben das Präfix. CodeTransformation: Im Folgenden finden Sie ein Beispiel VS Code für ein Protokoll, das aufgrund eines Fehlers beim Maven Kopieren von Abhängigkeiten generiert wurde:

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

Wie finde ich meine Transformationsjob-ID?

Finden Sie Ihre Job-ID in JetBrains

Um eine Transformationsjob-ID in zu findenJetBrains, gehen Sie im Transformation Hub zur Registerkarte Transformationsdetails und wählen Sie das Symbol Jobstatus anzeigen (Uhr).

Finden Sie Ihre Job-ID in Visual Studio Code

Um eine Transformationsjob-ID in VS Code zu finden, gehen Sie zum Transformation Hub und wählen Sie das Symbol Jobstatus anzeigen (Uhr).