Windows 下 Nginx 默认不支持 lua_resty_core，必须使用 OpenResty；下载其 Windows 版解压后用自带 nginx.exe，通过 nginx -V 验证 luajit 和 lua 模块，配置 location 用 content_by_lua_block 调用 require "resty.core" 即可验证成功。
Windows 下的 Nginx 默认不支持 Lua 模块，更不内置 lua_resty_core —— 这个库是 OpenResty 的一部分，依赖于 OpenResty 提供的定制版 Nginx + LuaJIT + 扩展模块。纯官方 Windows 版 Nginx 无法直接启用该库。
必须使用 OpenResty 替代原生 Nginx
lua_resty_core 是 OpenResty 自研的核心 Lua 库，对 Nginx C API 做了深度封装，并依赖 OpenResty 特有的 LuaJIT 补丁和底层 hook 机制。官方 Nginx for Windows 编译时未集成这些组件，也无法通过简单添加模块启用。
- 前往 OpenResty 官网下载 Windows 版本（如
openresty-1.21.4.2-win64.zip） - 解压后直接使用其自带的
nginx.exe，无需额外编译或安装 - 确认版本：运行
nginx -V 2>&1 | findstr "lua"，应看到--with-luajit和--with-http_lua_module
验证 lua_resty_core 是否可用
该库默认随 OpenResty 自动加载，无需手动 require 或配置。但需确保在 Lua 代码中正确调用：
- 在
nginx.conf的http或server块中启用 Lua 支持：lua_package_path ";;"; # 保持默认路径即可 - 写一个测试 location：
location /test-lua {<br> content_by_lua_block {<br> local core = require "resty.core"<br> core.post_args()<br> ngx.say("lua_resty_core is working")<br> }<br>}
访问 http://localhost/test-lua，若返回文本即表示成功。
常见失败原因与修复
-
误用官方 Nginx + 第三方 lua-nginx-module：Windows 下几乎无法稳定编译该模块，且即使编译成功也不含
lua_resty_core -
路径冲突或旧版残留：确保系统 PATH 中没有其他 nginx 或 lua 相关路径干扰；删除旧版 Nginx 配置中所有
lua_*指令后再试 -
require 失败提示 "module 'resty.core' not found"：检查是否用了 OpenResty 的
nginx.exe启动，而非其他 nginx 可执行文件
进阶：自定义 resty.core 行为（可选）
该库默认开启优化（如 JIT 编译、API 缓存），如需调试可临时禁用：
- 在
http块中添加：lua_code_cache off;（开发时启用，避免缓存导致修改不生效） - 在 Lua 代码开头显式初始化（非必需，仅用于强制重载）：
require "resty.core".init()
