mod_lua 不适合复杂动态路由，因其无事件循环、不支持异步I/O、无法热重载、不能维持长连接；仅支持基于请求头、路径、参数的只读判断，复杂逻辑需换用Nginx+OpenResty或APISIX。
mod_lua 不适合做复杂动态路由
Apache 的 mod_lua 本质是嵌入式钩子运行时，不是应用服务器。它没有独立事件循环、不支持异步 I/O、无法热重载、不能维持长连接——所有这些限制都直接卡死「复杂动态路由」的实现前提。你写一个基于 ngx.var.arg_uid 取模转发的逻辑，在 Nginx + OpenResty 里是常态；但在 Apache + mod_lua 中，一旦你要查 Redis、调外部鉴权 API、或解析 JSON body，就会立刻遇到 attempt to yield across C-call boundary 错误，或者直接超时返回 500。
能跑通的“动态”仅限于请求头/路径/参数的只读判断
如果你的路由逻辑只依赖以下三类输入，且不做任何阻塞操作，mod_lua 才可能勉强可用：
- 读取
r.headers_in["X-Forwarded-For"]或r.headers_in["User-Agent"]做黑白名单拦截 - 用
r:parseargs()拆 GET 参数，再配合string.match判断version=v2就改r.uri - 根据
r.hostname或r.uri长度做简单重写，例如把/api/internal/改成/internal-api/
注意：r.headers_in 是只读表，r.headers_out 必须在 Content-Type 设置前写入，否则会被 Apache 后续流程覆盖；r:errlog() 默认不输出，得开 LuaDebug on 和 ErrorLogLevel debug 才能看到。
真正需要复杂路由时，必须换架构
别在 mod_lua 上硬扛。生产环境有明确替代路径：
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 前端用 Nginx +
balancer_by_lua_block：支持实时健康检查、一致性哈希、调外部 HTTP 服务（用resty.http），且协程天然防阻塞 - API 网关层用 Apache APISIX：基于 OpenResty，插件机制成熟，
extra_lua_path可加载自定义 Lua 插件，优先级和执行阶段可控 - 验签/鉴权等强逻辑下沉为独立服务：Apache 只用
ProxyPass转发，由 Python/Go 服务完成 HMAC 校验、JWT 解析、DB 查询等耗时操作
强行在 mod_lua 里拼接 os.execute 或同步 socket 调用，只会让错误日志里反复出现 yield across C-call boundary，而你根本没法 debug —— 因为默认连报错都不打出来。
脚本改了不生效？不是缓存，是根本没被加载
mod_lua 默认启用代码缓存，但更常见的问题是：你写的 Lua 文件压根没被 Apache 加载。原因包括：
-
LuaHookHandler指向的路径不存在，或权限不足（Apache 进程用户不可读） - 配置中漏了
LuaCodeCache off（开发期必须加，否则改完要 reload 整个 httpd） - 脚本语法正确但运行时报 nil 访问，错误被静默吞掉，除非开了
LuaDebug on - 用了
require "json"却没把 lua-json 安装到LUA_PATH对应路径下
最稳妥的验证方式：在脚本开头加 r:errlog("lua script loaded")，再看 error_log 是否出现这行——没出现，说明 Apache 根本没执行它，别急着 debug 逻辑。
