本地Azure DevOps Linux代理NuGet配置访问权限异常求助

• 本地Linux代理与Azure托管代理的核心差异在于工作区复用机制：托管代理每次运行后会重置到干净状态，而本地代理长期运行、复用同一工作目录，异常终止的任务会遗留权限问题。
• 首次PowerShell任务失败（exit 1）时，流水线异常终止，未触发正常的工作区清理流程，导致任务中错误生成的文件/目录（比如误把$HOME作为字面量创建的路径/agent/_work/1/s/$HOME）权限混乱——大概率是用高权限用户（如root）创建了该目录，而代理运行用户是普通用户，无法访问。
• Linux环境下用PowerShell任务容易出现环境变量解析错误：$HOME在Bash和PowerShell Linux版中的解析逻辑不同，误操作会在工作目录下生成带$HOME字面量的目录，后续拉取资源时触发权限校验失败。

• 紧急修复损坏的代理：
  手动清空代理工作区并重置权限，然后重启代理：

  # 停止代理服务
  sudo systemctl stop azure-devops-agent.service
  # 清空工作区
  rm -rf /agent/_work/*
  # 重置工作区权限为代理运行用户
  sudo chown -R $(whoami):$(whoami) /agent/_work
  # 重启代理
  sudo systemctl start azure-devops-agent.service
  

• 强制流水线清理工作区：
  在流水线的checkout步骤中开启clean选项，确保每次运行前清空工作区：

  steps:
  - checkout: self
    clean: true
    fetchDepth: 1
  

• 替换PowerShell任务为Bash任务：
  Linux环境下优先用Bash任务，避免跨Shell的环境变量解析问题，减少路径错误概率。
• 添加任务失败后的清理逻辑：
  如果必须用PowerShell任务，在任务中加入异常捕获和清理步骤：

  try {
      # 你的业务逻辑代码
  }
  catch {
      # 清理错误生成的$HOME目录
      Remove-Item -Path "$(System.DefaultWorkingDirectory)/`$HOME" -Recurse -Force -ErrorAction SilentlyContinue
      exit 1
  }
  

• 规范代理运行权限：
  确保本地代理始终以同一个普通用户启动，禁止在流水线任务中使用sudo；若必须使用高权限操作，执行后要将生成文件的权限改回代理用户：

  sudo your-command
  sudo chown -R $(whoami):$(whoami) /path/to/generated-files
  

内容的提问来源于stack exchange，提问作者orange-lily