用 strace 定位程序启动时配置文件未找到问题

问题场景

服务启动失败，日志只有 config file not found，但运维明明在 /etc/myapp/myapp.conf 放了配置文件。应用可能依次查找 $MYAPP_CONFIG、./myapp.conf、/etc/myapp/myapp.conf 等路径。报错只告诉你“没找到”，不会告诉你它实际查了哪些路径、在哪个路径失败。strace 可以跟踪系统调用，把 openat 和 access 的真实路径与返回值打印出来。

最小可运行示例

下面这个 C 程序模拟常见的配置文件查找逻辑：先读环境变量，再读当前目录，最后读两个系统目录。

#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
#include <errno.h>
#include <string.h>

static int try_load(const char *path) {
    if (access(path, R_OK) != 0) {
        fprintf(stderr, "access %s: %s\n", path, strerror(errno));
        return -1;
    }
    FILE *fp = fopen(path, "r");
    if (!fp) {
        fprintf(stderr, "fopen %s: %s\n", path, strerror(errno));
        return -1;
    }
    printf("loaded config: %s\n", path);
    fclose(fp);
    return 0;
}

int main(void) {
    const char *env = getenv("MYAPP_CONFIG");
    const char *paths[4];
    int n = 0;
    if (env && *env) paths[n++] = env;
    paths[n++] = "./myapp.conf";
    paths[n++] = "/etc/myapp/myapp.conf";
    paths[n++] = "/usr/local/etc/myapp.conf";

    for (int i = 0; i < n; i++) {
        if (try_load(paths[i]) == 0) return 0;
    }
    fprintf(stderr, "config file not found\n");
    return 1;
}

编译并准备运行目录：

gcc -Wall -O0 -g -o myapp myapp.c
mkdir -p /tmp/myapp-demo
cp myapp /tmp/myapp-demo/
cd /tmp/myapp-demo

运行跟踪命令：

strace -e trace=openat,access -f ./myapp

如果当前目录和示例系统路径都没有配置文件，会看到类似输出（路径为占位示例）：

access("./myapp.conf", R_OK) = -1 ENOENT (No such file or directory)
access("/etc/myapp/myapp.conf", R_OK) = -1 ENOENT (No such file or directory)
access("/usr/local/etc/myapp.conf", R_OK) = -1 ENOENT (No such file or directory)
write(2, "config file not found\n", 22) = 22

动态链接器也可能产生很多 openat，通常可以过滤：

strace -e trace=openat,access -f -o trace.log ./myapp
grep -E 'myapp\.conf|app\.conf|config' trace.log

如何读结果

重点看三列：系统调用名、路径、返回值。

• access("./myapp.conf", R_OK) = -1 ENOENT：进程尝试用相对路径查找，并且相对于它的当前工作目录。若工作目录不是部署目录，就会找不到。
• access("/etc/myapp/myapp.conf", R_OK) = -1 ENOENT：绝对路径不存在，或者路径中某一级目录不存在。
• access("/etc/myapp/myapp.conf", R_OK) = -1 EACCES：路径存在，但运行用户没有读权限；也可能是父目录缺少执行（搜索）权限。

ENOENT 和 EACCES 是最容易混淆的两个错误：

• ENOENT：No such file or directory。文件或目录不存在。排查方向是工作目录、安装路径、环境变量、软链接指向、容器挂载、systemd 的 WorkingDirectory。
• EACCES：Permission denied。文件或目录存在，但权限不足。排查方向是文件读权限、父目录 x 权限、运行用户、ACL、SELinux/AppArmor 等安全模块。

还要注意一个细节：access() 使用真实 UID/GID，而 openat() 使用有效 UID/GID。在 setuid 程序里，可能出现 access 检查通过但 openat 仍返回 EACCES 的情况。因此不要只看 access 的结果，也要看后续 openat。

边界与限制

1. 只跟踪 openat,access 可能不完整。程序也可能使用 open、stat、newfstatat 等调用，可改为 -e trace=file，或按需追加。
2. strace 有明显性能开销，适合在测试、排障时短时使用，不建议在生产高并发进程中长期挂载。
3. 在容器中运行需要 SYS_PTRACE 能力，Kubernetes 默认可能不允许。可进入容器执行，或在宿主机上按 PID 命名空间使用 nsenter。
4. 多进程程序要加 -f，输出会交错。可用 -o trace.log 汇总，或 -ff 按进程拆分文件。
5. 输出中的路径可能被截断，用 -s 256 增加显示长度。
6. 动态链接器正常搜索库时也会产生大量 ENOENT，需要结合程序名、配置文件名、时间顺序过滤，避免误判。
7. strace 只能看到系统调用，不能看到应用为什么选择这些路径。最终仍要结合源码、启动脚本、服务单元文件和实际部署目录确认。

小结

用 strace -e trace=openat,access -f ./myapp 可以把“配置文件未找到”还原成具体的查找路径和错误码。看到 ENOENT 先查路径和工作目录；看到 EACCES 先查权限和运行用户。先确认程序实际找哪里，再修正部署或权限，通常比反复猜测配置文件位置更有效。