ArgoCD WebUI加载异常仅显示空白页，已排查仍未解决

问题描述 #

ArgoCD WebUI无法正常工作，仅显示空白页。已完成以下排查步骤：

• 重启ArgoCD服务
• 从版本 quay.io/argoproj/argocd:v2.4.9 补丁升级至 quay.io/argoproj/argocd:v2.5.4
• 谷歌搜索相关解决方案但未找到有效办法

相关日志 #

time="2023-03-08T09:45:11Z" level=error msg="Failed to walk extensions directory: failed to iterate files in '/tmp/extensions/': lstat /tmp/extensions/: no such file or directory"
time="2023-03-08T09:46:18Z" level=info msg="received unary call /version.VersionService/Version" grpc.method=Version grpc.request.claims=null grpc.request.content= grpc.service=version.VersionService grpc.start_time="2023-03-08T09:46:18Z" span.kind=server system=grpc
time="2023-03-08T09:46:18Z" level=info msg="finished unary call with code OK" grpc.code=OK grpc.method=Version grpc.service=version.VersionService grpc.start_time="2023-03-08T09:46:18Z" grpc.time_ms=16.593 span.kind=server system=grpc
time="2023-03-08T09:46:22Z" level=info msg="received unary call /version.VersionService/Version" grpc.method=Version grpc.request.claims=null grpc.request.content= grpc.service=version.VersionService grpc.start_time="2023-03-08T09:46:22Z" span.kind=server system=grpc
time="2023-03-08T09:46:22Z" level=info msg="finished unary call with code OK" grpc.code=OK grpc.method=Version grpc.service=version.VersionService grpc.start_time="2023-03-08T09:46:22Z" grpc.time_ms=12.958 span.kind=server system=grpc
time="2023-03-08T09:50:27Z" level=error msg="Failed to walk extensions directory: failed to iterate files in '/tmp/extensions/': lstat /tmp/extensions/: no such file or directory"
time="2023-03-08T09:52:53Z" level=info msg="Alloc=13866 TotalAlloc=79804 Sys=47185 NumGC=29 Goroutines=76"

排查与解决建议 #

1. 检查WebUI静态资源加载情况 #

• 打开浏览器开发者工具（F12），切换到「网络」标签页，刷新页面，查看CSS、JS等静态资源的加载状态，是否存在404、500等错误
• 查看「控制台」标签页，是否有JavaScript报错，比如资源加载失败、语法错误等

2. 修复extensions目录缺失问题 #

日志中反复出现/tmp/extensions/目录不存在的错误，可尝试：

• 进入ArgoCD容器内手动创建目录：mkdir -p /tmp/extensions/
• 修改ArgoCD的Deployment配置，在容器启动命令前添加目录创建步骤，示例：

  command:
    - sh
    - -c
    - "mkdir -p /tmp/extensions/ && argocd-server <原启动参数>"
  

3. 验证ArgoCD API服务可用性 #

日志显示Version服务调用正常，但需确认其他API是否正常：

• 使用ArgoCD CLI执行argocd cluster list或argocd app list，检查是否能正常返回数据
• 直接访问ArgoCD API端点（如https://<你的ArgoCD地址>/api/v1/applications），确认是否返回合法JSON数据

4. 检查Ingress/路由配置 #

• 确认Ingress规则是否正确指向ArgoCD server服务，路径重写、TLS配置是否无误
• 若使用反向代理（如Nginx），检查代理配置是否正确，避免静态资源路径被错误改写

5. 清理浏览器缓存 #

版本升级后可能存在缓存冲突：

• 使用浏览器无痕模式打开WebUI测试
• 手动清理浏览器缓存，然后按Ctrl+F5强制刷新页面

内容的提问来源于stack exchange，提问作者sharad