Azure Pipelines Cache@2任务无法找到package-lock.json求助

算力阿峰

2026-7-19

问题分析

报错的核心原因是Cache@2任务默认从流水线工作目录的根路径查找package-lock.json，但你的文件实际位于src/MyApp/ClientApp/子目录，导致任务找不到文件触发异常。此外，后续的npm ci命令如果不指定工作目录，同样会因为找不到package文件而失败。

解决方案

需要调整两个关键部分：缓存key的文件路径、npm命令的工作目录，以下是修正后的YAML配置：

variables:
  npmCacheDirectory: $(Pipeline.Workspace)/.npm/
  # 定义ClientApp的路径，方便后续复用
  clientAppDir: src/MyApp/ClientApp

steps:
- task: Cache@2
  inputs:
    # 修正key中的package-lock.json路径，指向实际文件位置
    key: 'npm | "$(Agent.OS)" | $(clientAppDir)/package-lock.json'
    restoreKeys: |
       npm | "$(Agent.OS)"
    # 保留npm缓存目录的配置，或者直接使用$(npm_config_cache)也可
    path: $(npmCacheDirectory)
  displayName: Cache npm

# 在ClientApp目录下执行npm ci，确保能找到package-lock.json
- script: npm ci
  workingDirectory: $(clientAppDir)
  displayName: Install npm dependencies

关键修改说明

缓存key的文件路径修正：将package-lock.json替换为完整的相对路径$(clientAppDir)/package-lock.json，让Cache任务能准确定位到锁文件，生成正确的缓存键。
指定npm命令的工作目录：通过workingDirectory参数让npm ci在ClientApp目录下执行，确保npm能找到package.json和package-lock.json，同时也能正确使用缓存的npm包。
可选优化：定义clientAppDir变量复用路径，避免后续重复编写，提升配置的可维护性。