常见问题
以下是 YXShop 使用过程中常见的问题和解答。
安装相关
Q: composer install 报错怎么办？
请检查 PHP 版本是否 >= 8.1，并确保已安装所有必需的 PHP 扩展。可以运行 php -m 查看已安装的扩展。
Q: Windows 下无法启动怎么办？
Windows 环境请使用 php windows.php start 而不是 php start.php start。同时注意 Windows 不支持 pcntl 和 posix 扩展。
Q: 数据库导入报错怎么办？
确保 MySQL 版本 >= 5.7，数据库字符集为 utf8mb4。
配置相关
Q: 微信支付回调不成功？
请检查：1) 回调地址是否为 HTTPS；2) 回调地址是否外网可访问；3) 微信支付证书是否正确配置；4) 防火墙是否放行。
Q: 小程序登录失败？
请检查：1) AppID 和 Secret 是否正确；2) 服务器域名是否已配置到小程序白名单；3) 后端服务是否正常运行。
Q: AI 功能不可用？
AI 功能需要配置 API Key 并购买算力包。请在管理后台「AI 设置」中配置 OpenAI 或 Anthropic 的 API Key。
使用相关
Q: 如何修改默认管理员密码？
登录管理后台，进入「系统管理 - 管理员管理」，点击编辑修改密码。默认账号 admin / 123456。
Q: 如何配置小程序装修？
登录管理后台，进入「小程序管理 - 页面装修」，使用拖拽编辑器配置页面组件。
开发相关
Q: 如何新增一个 API 接口？
按照四层架构创建 Model -> Repository -> Service -> Controller，然后在路由文件中注册路由。详见 二次开发指南。
Q: 如何贡献代码？
欢迎提交 Pull Request 到 GitHub 仓库。请确保代码符合四层架构规范。