wheels-debugging
诊断常见Wheels错误并提供调试指导。在遇到错误、异常或意外行为时使用。为Wheels应用程序提供错误分析、常见解决方案和调试策略。
📖 中文导读:诊断常见Wheels错误并提供调试指导。在遇到错误、异常或意外行为时使用。为Wheels应用程序提供错误分析、常见解决方案和调试策略。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: Wheels Debugging description: Troubleshoot common Wheels errors and provide debugging guidance. Use when encountering errors, exceptions, or unexpected behavior. Provides error analysis, common solutions, and debugging strategies for Wheels applications.
Wheels Debugging
Common Errors
"Missing argument name" Error
Cause: Mixed positional and named arguments
Solution: Use consistent argument style
❌ hasMany("comments", dependent="delete")
✅ hasMany(name="comments", dependent="delete")
"Can't cast Object type [Query] to [Array]"
Cause: Using Array functions on queries
Solution: Use query methods
❌ ArrayLen(post.comments())
✅ post.comments().recordCount
"Association not found" Error
Cause: Association not properly defined or typo
Solution:
- Check model config() for association definition
- Verify association name matches
- Check model name spelling
"Table not found" Error
Cause: Migration not run or table name mismatch
Solution:
wheels dbmigrate latest
"Column not found" Error
Cause: Property doesn't exist in database
Solution:
- Add column via migration
- Check property name spelling
- Verify case sensitivity
Debugging Tools
Enable Debug Output
// In config/settings.cfm
set(showDebugInformation=true);
set(showErrorInformation=true);
Inspect Variables
<cfdump var="#post#" label="Post Object">
<cfabort>
Check SQL Queries
// Wheels logs all SQL to debugging output
// Look for red SQL queries (errors)
Generated by: Wheels Debugging Skill v1.0