审查 Phoenix 代码的控制器模式、上下文边界、路由和插件。用于审查 Phoenix 应用，检查控制器、路由器等。
凤凰网代码回顾 Q快参考
功能概述
凤凰网代码回顾 Q快参考是一项面向实际任务的技能，主要用于边框上下文, Ecto集成；参考/文本. md. 动作,参数,错误处理. 参考/控制器. md.；
核心要点
- Pipelines, expects, varifi。
- 它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
- 使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
使用与执行
该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；
结果检查与注意事项
若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。
Phoenix 代码审查
快速参考
| 问题类型 | 参考文档 |
|---|---|
| 限界上下文（Bounded contexts）、Ecto 集成 | references/contexts.md |
| 操作（Actions）、参数（params）、错误处理 | references/controllers.md |
| 管道（Pipelines）、作用域（scopes）、已验证路由（verified routes） | references/routing.md |
| 自定义 plug、认证（authentication） | references/plugs.md |
审查清单
控制器（Controllers）
- 业务逻辑置于 contexts 中，而非 controllers 中
- Controllers 返回正确的 HTTP 状态码
- Action 子句（clauses）覆盖所有预期的匹配模式
- Fallback controllers 以一致方式处理错误
上下文（Contexts）
- Contexts 按业务领域划分边界，而非按技术层级
- 公共函数命名清晰且聚焦于业务领域
- Changeset 对所有用户输入执行校验
- Controllers 中不包含 Ecto 查询
路由（Routing）
- 使用已验证路由（~p sigil），而非字符串路径
- Pipelines 将相关 plug 分组
- Resources 仅启用所需的操作（actions）
- Scopes 将相关路由分组
Plug
- 通过 plug 实现认证（authentication）与授权（authorization）
- Plug 具备可组合性，且职责单一
- 在 plug 中发送响应后调用
Plug.Conn.halt/1
JSON API
- 正确实现内容协商（content negotiation）
- 错误响应格式保持一致
- 列表类端点（list endpoints）支持分页（pagination）
有效模式（请勿标记）
- Controller 调用多个 contexts —— 适用于编排（orchestration）场景，属合理用法
- Context 中内联 Ecto 查询 —— Context 拥有其数据访问逻辑
- 使用
action_fallback—— 属集中式错误处理模式 - 单个路由配置多个 pipelines —— 属有意为之的组合设计
Plug.Conn.halt/1调用未伴随 send 操作 —— 可能由 fallback 处理
上下文敏感规则
| 问题 | 仅当满足以下条件时标记 |
|---|---|
| 缺失 changeset 校验 | 该字段接受用户输入，且当前无任何校验逻辑 |
| Controller 过大 | 包含超过 7 个 action，或任一 action 超过 20 行 |
| 缺失授权（authorization） | 该路由非公开（not public），且 pipeline 中未配置任何 auth plug |
审查门禁（Gates，按顺序执行；每步均有通过条件）
- 锚定证据（Anchored evidence） —— 对每个计划提出的发现（finding），需打开对应源文件并记录该次阅读所得的 文件路径 + 行号（不可仅依赖记忆或 diff 片段）。通过条件：每个发现均引用了你实际打开过的
path:line。 - “已在别处处理”扫描（“Handled elsewhere” sweep） —— 在报告“缺失校验”、“缺失授权”或“状态码错误”前，需搜索 router（pipelines/scopes）、controller（如
action_fallback、plug）及对应 context，确认是否存在已有检查逻辑。通过条件：你已明确记录该处理逻辑是否存在于其他位置（是 + 具体位置，或否 + 已完成完整搜索）。 - 验证协议（Verification protocol） —— 加载并应用针对该问题类型的 review-verification-protocol。通过条件：在撰写该类发现前，已满足该技能所要求的预报告检查项。
- 发现格式（Finding shape） —— 每个问题须以
[FILE:LINE] ISSUE_TITLE格式输出，并附带一行理由说明，且该理由必须直接关联所引用的代码。通过条件：每一行输出均符合该格式。
提交发现前
请勿提交任何发现，直至上述所有 Gates 均已通过。如需执行完整的防误报（anti-false-positive）流程，请遵循 review-verification-protocol。
相关专题
Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章，帮助读者完成上线流程。
2026.10.28
0
16
Vite搭配Vue.js专题汇集创建Vue 3项目、配置开发环境、路径别名、Vue插件、代理、多环境构建与调试的已审核文章，帮助读者完成从初始化到日常开发的配置。
2026.10.28
0
15
Vite项目目录专题汇集入口文件、src源码、public静态资源、路径别名、项目根目录和构建输出目录相关的已审核文章，帮助读者理解各文件夹的用途与引用方式。
2026.10.28
0
10
本专题介绍Gradle插件开发的基本流程，涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法，帮助你理解插件如何组织构建逻辑，减少多个项目之间的重复配置。
2026.10.22
0
11
本专题介绍Gradle Wrapper的基本作用，涵盖文件组成、生成方法、版本配置和任务调用，帮助你理解项目如何使用指定的Gradle版本，减少不同开发环境带来的构建差异。
2026.10.22
0
10
本专题整理Golangci-lint常用Linters的用途与配置方法，覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查，帮助项目合理选规则。
2026.10.22
0
15
本专题介绍Gradle Java项目构建方法，涵盖Java插件配置、依赖声明、源码编译、测试执行和打包检查，帮助你理解各阶段的任务关系，逐步完成项目构建。
2026.10.22
0
10
本专题汇总PHP常见时间戳漏洞，包括2038年溢出、时区漂移、时间戳伪造、重放攻击、时间盲注与日志审计失效等，并给出升级64位环境、使用 DateTimeImmutable、统一UTC、严格超时校验、预处理绑定、hash_equals 比对等修复方案，帮助开发者快速排查和加固时间相关代码。
2026.10.22
0
25
本专题聚焦Golangci-lint YAML配置文件，讲清运行参数、规则启停、目录排除、问题过滤及严重级别设置，便于团队统一检查标准。
2026.10.22
0
15
热门下载
相关下载
精品课程
共6课时 | 54.7万人学习
共89课时 | 134.1万人学习
共49课时 | 82.6万人学习
最新文章