Go 相对路径在服务启动目录变化后失效怎么办

我遇到过一种很容易误判的 Go 服务问题：本地在项目目录里启动，配置文件可以正常读取；换成脚本、容器或服务管理器启动后，程序突然提示文件不存在。代码没有改，文件也确实在部署目录里，真正变化的通常是进程的当前工作目录。

相对路径不是相对于 Go 源文件，也不是相对于二进制文件。它会从进程启动时的工作目录开始解释。处理这类问题的稳定做法是：启动阶段先读取并记录工作目录，把外部传入的相对路径一次性转换成绝对路径，之后让业务层只使用这份已经解析好的路径。

如果服务的启动目录可能变化，就不要把相对路径带进业务流程。用 os.Getwd 观察现场，用 filepath.Abs 在启动边界完成绝对化，并把工作目录是否可变写进启动契约。

先确认相对路径究竟从哪里开始

排查时我会先打印当前工作目录和原始参数，而不是马上把文件复制到另一个目录。这样可以区分“路径解析错了”和“文件确实不存在”两类问题。

package main

import (
    "fmt"
    "os"
)

func main() {
    // 工作目录决定了 config/app.yaml 这类相对路径的起点。
    cwd, err := os.Getwd()
    if err != nil {
        // 启动诊断失败时直接退出，避免继续使用未知路径。
        panic(fmt.Errorf("读取当前工作目录失败: %w", err))
    }

    configPath := "config/app.yaml"
    fmt.Printf("cwd=%s\\nconfig=%s\\n", cwd, configPath)
}

同一份二进制从项目根目录启动时，config/app.yaml 可能指向项目下的配置；从 / 或临时目录启动时，它就会指向完全不同的位置。日志中的相对参数本身没有告诉你最终访问了哪里，所以 cwd 是第一条需要保留的现场信息。

在启动边界把路径绝对化

filepath.Abs 适合放在配置加载或启动初始化阶段。它会把非绝对路径和当前工作目录拼接，再清理路径中的冗余片段；如果输入本来就是绝对路径，则不会因为当前目录改变而重新解释它。

package main

import (
    "fmt"
    "path/filepath"
)

// resolveInputPath 将外部参数固定为启动阶段解析出的绝对路径。
func resolveInputPath(input string) (string, error) {
    if input == "" {
        return "", fmt.Errorf("路径参数不能为空")
    }

    // Abs 只负责路径表达，不负责检查文件是否存在。
    absolute, err := filepath.Abs(input)
    if err != nil {
        return "", fmt.Errorf("绝对化路径 %q 失败: %w", input, err)
    }
    return absolute, nil
}

这里有一个容易漏掉的边界：绝对化成功不等于文件存在。filepath.Abs 解决的是“从哪里解释路径”，文件是否存在、是否有权限读取，要交给后续的打开操作处理。把这两个阶段分开，错误信息会更容易看懂。

把绝对路径传给后续加载逻辑

我更倾向于让入口函数完成一次解析，然后把绝对路径交给加载器。这样业务函数不需要知道服务是从哪个目录启动的，也不会在不同调用点重复拼接。

package main

import (
    "fmt"
    "os"
    "path/filepath"
)

func loadConfig(input string) ([]byte, string, error) {
    // 在入口边界固定路径，后续流程只接收绝对路径。
    absolute, err := filepath.Abs(input)
    if err != nil {
        return nil, "", fmt.Errorf("解析配置路径 %q 失败: %w", input, err)
    }

    // 读取失败要保留最终路径，便于区分目录错误和权限错误。
    data, err := os.ReadFile(absolute)
    if err != nil {
        return nil, absolute, fmt.Errorf("读取配置 %q 失败: %w", absolute, err)
    }
    return data, absolute, nil
}

func main() {
    // 命令行、环境变量或默认值都可以作为 input，但只在这里解析一次。
    data, absolute, err := loadConfig("config/app.yaml")
    if err != nil {
        panic(err)
    }
    fmt.Printf("loaded=%s bytes=%d\\n", absolute, len(data))
}

如果服务支持环境变量或命令行参数，建议优先让部署系统传入绝对路径；默认值可以保留相对路径，但要在启动时尽早解析并打印最终值。这样启动日志可以直接回答“程序究竟读了哪个文件”。

不要在运行中随意切换工作目录

os.Chdir 会改变当前进程的工作目录。它看起来能快速修复某个相对路径问题，但也会改变同一进程里其他相对路径的解释方式。服务有并发请求、后台任务或多个资源加载点时，运行中切换目录会让调用之间共享一个隐含状态。

package main

import (
    "fmt"
    "os"
    "path/filepath"
)

func main() {
    // 如果必须改变目录，只把它当作启动配置动作，并在后续流程前完成。
    root := "/srv/my-service"
    if err := os.Chdir(root); err != nil {
        panic(fmt.Errorf("切换服务工作目录 %q 失败: %w", root, err))
    }

    // 切换后立即获取新的绝对目录，记录启动契约的实际值。
    cwd, err := os.Getwd()
    if err != nil {
        panic(fmt.Errorf("确认服务工作目录失败: %w", err))
    }
    config, err := filepath.Abs("config/app.yaml")
    if err != nil {
        panic(fmt.Errorf("解析配置路径失败: %w", err))
    }
    fmt.Printf("cwd=%s config=%s\\n", cwd, config)
}

更推荐由启动命令或服务管理器设置工作目录，而不是让业务代码主动 Chdir。如果确实要调用它，应在任何 goroutine 启动前完成，并把最终工作目录写入日志；运行中不要为了某一个文件临时切换目录再切回来。

服务启动失败时按这张表排查

结论：相对路径可以作为输入，不能作为长期隐含状态

相对路径并不是不能用，问题在于它依赖一个容易变化的工作目录。命令行小工具可以接受相对路径；长期运行的服务则应在启动边界记录 os.Getwd，用 filepath.Abs 固定最终位置，再把绝对路径传给加载逻辑。这样服务从哪里启动不再是业务代码里的隐藏前提。

相关问题

• 为什么同一个 Go 二进制在终端和服务管理器下读取到的配置不同？
• filepath.Abs 成功后是否代表目标文件已经存在？
• 什么时候应该设置工作目录，什么时候应该直接传绝对路径？