Caddy无法加载index.html：本地开发API静态文件服务异常排查

解决方案 #

• 修正Caddyfile语法错误
  Caddyfile不允许指令末尾添加多余分号，修改后的配置如下：

  dev.lan {
    tls internal
    root * /var/www/app
    file_server
  }
  

• 重启Caddy容器
  执行命令加载新配置：

  docker-compose restart caddy
  

• 补充验证（可选）
  确保本地hosts文件已添加域名解析：

  127.0.0.1 dev.lan
  

  浏览器访问时需信任Caddy生成的自签名证书（你已确认证书正常，此步可跳过）

问题原因 #

原Caddyfile中root * /var/www/app;的分号违反了Caddyfile语法规则，导致Caddy无法正确识别静态文件根目录，无法找到index.html文件，最终返回空白页面。容器内文件存在、证书状态正常，排除这两类问题。

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