Yii框架的RESTful接口完全适合单体应用，是构建可维护后端服务的合理选择；其ActiveController本质是带预设CRUD行为的控制器基类，运行于单体进程内，无需额外通信开销，且便于前后端协作与未来演进。
Yii 框架的 RESTful 接口完全适合单体应用，不仅适合，而且是单体架构下构建可维护、可演进后端服务的合理选择。
Yii 的 yii\rest\ActiveController 在单体中怎么用
它不是为微服务“专属”设计的，本质就是一个带预设行为（index、view、create 等）的控制器基类，运行在单体应用的同一个进程里。
- 直接继承
yii\rest\ActiveController，指定$modelClass即可启用标准 CRUD 路由和响应格式 - 所有逻辑仍走单体的统一入口（如
web/index.php），不引入额外通信开销或部署复杂度 - 权限、日志、缓存等中间件仍由单体全局配置统一管理，无需跨服务协调
- 若需定制行为（比如只开放
index和view），重写$actions属性即可，不用动框架核心
为什么单体项目还要用 RESTful 风格
这不是为了“假装微服务”，而是解决单体内部的接口契约与协作问题。
- 前端团队（Vue/React）依赖稳定 JSON 接口，RESTful 提供清晰的 URL 语义（
/api/usersvs/user/list），降低前后端对齐成本 - 后续若拆服务，已有接口路径和返回结构可基本复用，避免重构时重写全部 API 层
-
yii\rest\Controller自动处理内容协商（Accept: application/json）、HTTP 状态码（404/422/201）和序列化，比手写Json::encode()更可靠 - 配合
yii\filters\ContentNegotiator和yii\filters\Cors，能快速支持跨域和多格式响应，适合混合前端场景
容易踩的坑：单体里开 RESTful 的典型错误
把 RESTful 当成“必须全盘照搬”的教条，反而增加单体负担。
- 盲目套用 HATEOAS 或超媒体链接——单体内部跳转用路由名（
Url::to()）更轻量，没必要塞_links - 给每个小功能都建独立 controller（如
UserLoginController），破坏 RESTful 资源边界；应优先按资源聚合（UserController处理用户全生命周期） - 忽略单体已有的 RBAC 权限体系，另起一套基于 HTTP 方法的权限控制（如只允许 POST 创建），导致权限逻辑分散
- 未关闭调试模式下的敏感信息暴露：
yii\rest\Serializer默认会输出模型验证错误详情，在生产环境需显式配置serializeData或自定义errorHandler
关键点在于：RESTful 是一种接口组织方式，不是架构分层。在单体里用它，重点是收敛契约、利当前开发、留未来余地——而不是强行模仿分布式语义。真正容易被忽略的，是忘记把 yii\rest\Controller 当作“增强版普通 controller”来用，而非某种必须隔离的“服务边界”。
