laravel 做主应用、lumen 做微服务是轻量落地微服务的务实选择：laravel 负责网关、会话、编排和后台，lumen 专注高并发独立模块；共用 redis 队列、统一日志与配置，通过 laravel-modules 抽离共享逻辑，部署时用 horizon 监控、guzzle 实现链路追踪。
用 Laravel 做主应用、Lumen 做微服务，是轻量落地微服务架构的务实选择。关键不在框架多酷，而在职责清晰、通信可靠、部署可控。
明确分工：什么交给 Laravel，什么留给 Lumen
Laravel 适合承担网关层、用户会话管理、复杂业务编排和后台管理；Lumen 则专注单一高并发能力，比如短信发送、订单状态轮询、支付回调处理、日志上报等独立功能模块。
- Laravel 启用完整服务（Session、CSRF、Blade、队列监听器、事件广播）
- Lumen 关闭非必要组件（如 Session、View），只保留路由、Eloquent（可选）、队列、缓存、Guzzle HTTP 客户端
- 两者共用同一数据库时，Lumen 不启用迁移命令（避免误操作），由 Laravel 统一管理 schema 变更
共享基础配置与通信机制
跨项目协作不靠复制代码，而靠约定和基础设施。
- 使用同一 Redis 实例作为队列驱动（database 驱动也可，但 Redis 更推荐）
- Laravel 分发任务时指定连接名（如 redis），Lumen 的
.env中配置相同 QUEUE_CONNECTION=redis - 日志统一写入文件或转发到 ELK/Sentry，Lumen 集成 rap2hpoutre/laravel-log-viewer 可快速查看
- 环境变量结构保持一致（如 DB_HOST、REDIS_HOST、JWT_SECRET），便于 Docker Compose 或 K8s ConfigMap 管理
模块化协同：用 laravel-modules 统一管理功能边界
即使分属不同框架，核心业务逻辑（如用户认证、权限校验、通用工具类）可抽为共享模块，通过 Composer 包或 Git Submodule 引入。
- 在 Laravel 和 Lumen 项目中都安装 nwidart/laravel-modules
- 将通用模型、API 响应封装、JWT 工具类放入 modules/Core，并发布为私有 Packagist 包
- Lumen 的
bootstrap/app.php中注册模块服务提供者：$app->register(\Nwidart\Modules\LumenModulesServiceProvider::class); - 各模块内定义自己的路由和服务绑定，避免全局污染
部署与运维要点
混合部署不是简单起两个容器，而是建立可追踪、可隔离、可伸缩的运行单元。
- Lumen 微服务建议用 Supervisor 或 systemd 托管队列进程（
php artisan queue:work --tries=3） - Laravel 主应用开启 Horizon 监控所有队列，包括发往 Lumen 的任务
- 用 Guzzle 封装统一 API 客户端，在 Laravel 中调用 Lumen 接口时自动携带 trace-id，便于链路追踪
- 健康检查端点统一暴露（如
/health），Nginx 层做负载与熔断，避免单点故障扩散
