不能用 io.open / os.execute 等标准方式，因会阻塞 Nginx 单线程 worker 进程，引发性能崩溃、fd 泄漏与权限越界；应使用 OpenResty 提供的异步机制（如 lua-resty-upload、ngx.location.capture、ngx.log）替代。
直接在 Nginx 的 Lua 环境中读写本地文件，存在严重风险：ngx_lua 是事件驱动、多 worker 共享进程模型，Lua 代码运行在 Nginx 的 HTTP 请求处理阶段（如 content_by_lua_block），而标准 Lua 的 io.open() 等同步 I/O 操作会阻塞整个 worker 进程，导致高并发下性能断崖式下降，甚至服务不可用。因此，不推荐、也不应直接使用 Lua 标准库进行文件读写。
为什么不能用 io.open / os.execute 等标准方式
原因很明确：
- Nginx worker 是单线程、非阻塞的，调用阻塞式系统调用（如 open/read/write/close）会让该 worker 暂停响应所有请求；
- Lua 标准库无协程调度能力，无法与 Nginx 的 event loop 协同；
- 文件描述符（fd）由操作系统管理，worker 进程内手动打开/关闭 fd 容易引发泄漏（如异常退出未 close）、竞争（多请求并发操作同一文件）、权限越界（Nginx 运行用户通常为 nobody 或 nginx，无权访问任意路径）；
- OpenResty 提供的
resty.file或ngx.location.capture等机制才是安全路径，它们基于 Nginx 原生异步 I/O 或子请求委托。
推荐替代方案：用 OpenResty 原生安全机制代替直接 fd 操作
真正符合生产要求的做法，是绕过“自己管理 fd”的思路，转而利用 OpenResty 已验证的异步或隔离机制：
-
上传场景：用
lua-resty-upload模块流式解析 multipart body，配合ngx.req.socket()+sock:receive()分块接收，再通过ngx.location.capture转发到后端 agent（如你知识库中描述的 TCP agent 架构），完全不落地到 Nginx 本机磁盘； -
下载场景：用
ngx.exec或ngx.redirect重定向到静态文件服务 location（如location ~ \.bin$ { alias /data/uploads/; }），由 Nginx 自身 sendfile 零拷贝输出，不经过 Lua 内存； -
必须落盘的元数据/日志：使用
lua-resty-logger-socket异步发往 syslog 或 log server；或用ngx.log记录到 Nginx error_log（它由 master 进程安全轮转，不涉及 worker fd 管理）； -
极小量配置/临时状态读取：用
init_by_lua_block预加载只读文件内容到 Lua table（如 JSON 配置），避免每次请求重复 open；写操作则绝对禁止在请求阶段执行。
若真需 Lua 层操作本地文件（仅限低频、非关键路径）
必须满足以下硬性约束：
- 仅限
init_by_lua_block或init_worker_by_lua_block阶段，且仅用于初始化（如加载证书、模板）； - 使用
resty.file（需自行封装）或ffi调用openat/read/close并严格配对，但需自行处理 errno、EINTR、EAGAIN； - 文件路径必须白名单校验（如限定在
/etc/nginx/conf.d/或/usr/local/openresty/conf/下）； - 必须设置超时和最大 size 限制，防止恶意大文件耗尽内存或 fd；
- 禁止在
access_by_lua_block、content_by_lua_block中执行任何阻塞 I/O。
文件描述符泄漏的自查与防护
线上可快速验证是否出现 fd 泄漏：
- 查 worker 进程 fd 数：
ls -l /proc/$(cat /usr/local/openresty/nginx/logs/nginx.pid)/fd/ | wc -l，正常应稳定在 10–50；持续增长即异常； - 在
init_worker_by_lua_block中用collectgarbage("count")监控 Lua 内存，间接反映资源持有情况； - 配置
worker_rlimit_nofile（如 65535），并监控系统级cat /proc/sys/fs/file-nr； - 启用
lua_code_cache off仅限调试，上线必须开启，否则每次 reload 会累积旧 Lua 状态。
