Go Echo框架结合Embed：systemctl启动时静态文件无法访问问题

问题根源 #

本地运行时，程序工作目录包含static文件夹，默认静态文件中间件可正常读取文件；但通过systemctl启动时，服务的工作目录通常并非二进制文件所在目录，且你已用go:embed将静态文件嵌入二进制，却未让Echo的静态中间件使用嵌入的文件系统，导致中间件尝试读取服务器本地不存在的文件路径，最终出现静态文件无法访问的问题。

修复步骤 #

使用Echo的StaticFS方法，明确指定使用嵌入的content文件系统提供静态文件，替换原有的静态文件相关配置：

修改后的核心代码 #

//go:embed app/views/*/*.tmpl static/*
var content embed.FS

func main() {
    // ... 其余代码保持不变 ...

    // 移除原有的三行静态文件配置：
    // e.Use(middleware.Static(""))
    // e.Use(middleware.Static("static"))
    // e.Static("/static", "static")

    // 替换为StaticFS，绑定嵌入的文件系统与路径
    e.StaticFS("/static", echo.MustFS(content, "static"))

    // ... 其余代码保持不变 ...
}

额外说明 #

• echo.MustFS会提前验证嵌入路径的有效性，避免运行时出现路径错误；
• 确保go:embed指令中的static/*已覆盖所有需要嵌入的静态文件；
• 清理重复的静态中间件配置，避免路径冲突；
• 重新编译二进制文件并部署到EC2，重启systemctl服务即可生效。

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