Felsöka dotnetup

Den här artikeln beskriver vanliga dotnetup problem och hur du åtgärdar dem.

Samla in diagnostikinformation

Samla in den här informationen innan du felsöker ett problem:

• Visa dotnetup version, arkitektur, körningsidentifierare och de verifierade installationerna:

  dotnetup --info
  

• Visa de spårade installationsspecifikationerna och installationerna och verifiera filerna på disken:

  dotnetup list
  

• Jämför den lagrade miljökonfigurationen med den aktuella miljön:

  dotnetup env show
  

• Kör det misslyckade kommandot igen med detaljerade utdata. Ett exempel:

  dotnetup sdk install 10.0 --verbosity detailed
  

Projekt kan inte byggas eller så startar inte appar efter installationen

Symptom: När du har konfigurerat dotnetup i everywhere-läge på Windows kan projekt som tidigare kunde byggas kan nu inte byggas. Eller så visar ramverksberoende appar det här felet:

You must install or update .NET to run this application.

Orsak: I everywhere läget har den dotnetup-hanterade installationen företräde framför den datoromfattande installationen i Program Files. SDK:er och körmiljöer som bara finns i den datorgemensamma installationen är inte tillgängliga.

Lösning: Migrera de datoromfattande SDK:erna och runtimerna till den dotnetup-hanterade installationen:

dotnetup sdk install --migrate-from-system
dotnetup runtime install --migrate-from-system

Eller ändra till åtkomstläget shell eller none. Mer information finns i Överväganden för läget Överallt.

dotnet använder inte den dotnetup-hanterade installationen

Symptom: Kommandot dotnet i terminalen använder inte de SDK:er som dotnetup installerade.

Orsak: Terminalen var öppen innan dotnetup ändrade miljön, eller så matchar inte miljökonfigurationen den lagrade konfigurationen.

Solution:

1. Öppna en ny terminal. Ändringar i shell-profilen eller Windows miljövariabler påverkar inte terminaler som redan är öppna.

2. Kör dotnetup env show. Om den rapporterar drift kör du dotnetup env set för att tillämpa den lagrade konfigurationen igen.

3. Om du bara vill konfigurera den aktuella terminalen kör du resultatet från dotnetup env script. Till exempel i Bash eller zsh:

   eval "$(dotnetup env script)"
   

   I PowerShell:

   dotnetup env script --shell pwsh | Invoke-Expression
   

Mer information finns i Hantera dotnetup-miljön.

Installationssökvägen innehåller redan en ospårad installation

Symptom: Ett installationskommando misslyckas med det här felet:

The install path '<path>' already contains a .NET installation that is not tracked by dotnetup. To avoid conflicts, use a different install path, remove the existing installation first, or use the --untracked option to install without tracking.

Orsak:dotnetup installerar inte spårade filer i en mapp som innehåller en .NET-installation som den inte spårar. Den här kontrollen förhindrar att dotnetup blandar sina filer med filer som ett annat verktyg äger.

Lösning: Gör något av följande:

• Välj en annan mapp med hjälp av alternativet --install-path.
• Ta bort den befintliga installationen från mappen.
• Om ett annat verktyg äger mappen använder du alternativet --untracked . dotnetup listar, uppdaterar eller tar bort inga ospårade filer.

Mer information finns i artikeln Hantera anpassade installationskataloger.

Den körbara filen dotnet används

Symptom: På Windows visar ett installationskommando en varning som liknar det här meddelandet:

Warning: Could not update dotnet executable at '<path>' - it is currently in use by another process. Close all running .NET applications and try again. The existing muxer will be retained. ...

Orsak: En körningsprocess använder den dotnet körbara filen, så dotnetup kan inte ersätta den. Installationen fortsätter med den befintliga dotnet körbara filen. En ny körningsmiljö kan kräva en nyare dotnet körbar fil.

Lösning: Stäng alla .NET-appar, IDE:er och byggservrar som körs. Kör sedan installationskommandot igen. Om du vill att kommandot ska misslyckas i stället för att fortsätta med en varning använder du alternativet --require-muxer-update .

En annan dotnetup-process körs

Symptom: Ett kommando visar det här meddelandet och väntar:

Another dotnetup process is running. Waiting for it to finish...

Orsak:dotnetup den serialiserar ändringar i tillståndet för delad installation. Ett annat dotnetup kommando ändrar samma tillstånd.

Lösning: Vänta tills det andra kommandot har slutförts. Om inga andra dotnetup processer körs, leta efter dotnetup processer som slutade svara och avsluta dem.

Manifestet är korrupt

Symptom: Ett kommando misslyckas med det här felet:

The dotnetup manifest at <path> is corrupt. Consider deleting it and re-running the install.

Meddelandet kan också säga att filen ändrades utanför dotnetup.

Orsak:dotnetup_manifest.json-filen är inte giltig. En annan process eller en manuell redigering kan ha ändrat filen.

Lösning: Ta bort manifestfilen och dess .sha256 fil från dotnetup-datakatalogen. Installera sedan om de SDK:er och runtimes som du behöver. Eftersom manifestet inte längre spårar den befintliga installationsroten kan du också behöva ta bort mappen först. Information om platsen för datakatalogen finns i Uppdatera eller ta bort dotnetup.

Konfigurationsfilen är skadad

Symptom: Ett kommando visar den här varningen:

Warning: The dotnetup config file at <path> appears to be corrupted and could not be read: ...

Orsak: Filen dotnetup.config.json är inte giltig. dotnetup ignorerar filen.

Lösning: Kör dotnetup env set med det åtkomstläge du vill använda eller kör dotnetup init igen. Dessa kommandon skapar en ny konfiguration.

En skalprofil innehåller ett felaktigt dotnetup-block

Symptom: Ett env kommando misslyckas med ett fel som liknar det här meddelandet:

The shell profile '<path>' contains a malformed dotnetup block: '<begin marker>' does not have a matching '<end marker>'. Remove or repair the block manually and try again.

Orsak:dotnetup markerar de rader som läggs till i en skalprofil med start- och slutkommentarer. En av dessa kommentarer saknas.

Lösning: Öppna shell-profilen i en textredigerare. Ta bort det ofullständiga dotnetup-blocket eller lägg till markören som saknas. Kör sedan kommandot igen.

Höjning av behörighet avbröts

Symptom: På Windows visar ett kommando som aktiverar eller inaktiverar everywhere läget följande meddelande:

Elevation was cancelled. The system PATH was not modified.

Orsak: Ändringar i systemet PATH kräver utökade privilegier. UAC-prompten (User Account Control) avbröts.

Lösning: Kör kommandot igen och godkänn UAC-prompten. Eller välj åtkomstläget shell eller none, som inte kräver utökade privilegier.

Ett versionsmanifest har upphört att gälla

Symptom: En installation eller uppdatering misslyckas med felkoden ExpiredNow under verifiering av versionsmanifestet.

Orsak: Den aktuella systemtiden är vid eller efter manifestets förfallotid. Manifestet kan ha upphört att gälla eller så kan systemklockan vara felaktig. En giltig signatur gör inte ett utgånget manifest acceptabelt.

Solution:

1. Kontrollera systemets datum och tid. Korrigera klockan om det behövs.
2. Försök igen med kommandot. Om en proxy levererar cachad versionsmetadata, be administratören kontrollera om den har ett manifest som har upphört att gälla.
3. Om klockan är korrekt och felet kvarstår rapporterar du problemet med kommandots detaljerade utdata.

Redigera inte manifestet eller ändra klockan för att kringgå förfallokontroller. Mer information finns i avsnittet Manifestets utgång.

En installation blockeras av en IT-policy

Symptom: En installation av en daglig version eller förhandsversion misslyckas med ett meddelande som säger att en IT-princip kräver kodsignerade nedladdningar.

Orsak: En administratör blockerade osignerade nedladdningar på datorn.

Lösning: Installera en version som släppts eller be administratören att rensa principen. Mer information finns i Hur dotnetup verifierar nedladdningar.

Rapportera ett problem

Om den här artikeln inte löser problemet söker du efter befintliga dotnetup-ärenden. Om du inte hittar någon matchning öppnar du ett nytt issue på dotnet/sdk-repo med dotnetup issue-mallen. Inkludera utdata från dotnetup --info och utdata från det misslyckade kommandot med --verbosity detailed.

För frågor och förslag använder du dotnetup discussions.

Se även

• Så här fungerar dotnetup
• dotnetup-miljökonfiguration
• dotnetup-kommandoreferens