2 lines
7.5 KiB
JavaScript
2 lines
7.5 KiB
JavaScript
import{_ as d,o as a,c as e,a2 as r}from"./chunks/framework.B-QBKwc1.js";const b=JSON.parse('{"title":"常见问题汇总","description":"本页汇总了项目各模块的常见问题及解决方案，按场景分类索引。","frontmatter":{},"headers":[],"relativePath":"zh/faq.md","filePath":"zh/faq.md"}'),h={name:"zh/faq.md"};function o(l,t,i,n,c,s){return a(),e("div",null,[...t[0]||(t[0]=[r('<h1 id="常见问题汇总" tabindex="-1">常见问题汇总 <a class="header-anchor" href="#常见问题汇总" aria-label="Permalink to "常见问题汇总""></a></h1><div class="tip custom-block"><p class="custom-block-title">说明</p><p>本页汇总了项目各模块的常见问题及解决方案，按场景分类索引。遇到问题时可先查阅本页，再深入各章节详细文档。</p></div><h2 id="环境与启动" tabindex="-1">环境与启动 <a class="header-anchor" href="#环境与启动" aria-label="Permalink to "环境与启动""></a></h2><table tabindex="0"><thead><tr><th>问题</th><th>说明</th><th>详细文档</th></tr></thead><tbody><tr><td>PHP 版本低于 8.2</td><td>项目要求 PHP >= 8.2</td><td><a href="/zh/quickstart/environment.html">环境准备</a></td></tr><tr><td>缺少 pdo_mysql 扩展</td><td>数据库驱动缺失</td><td><a href="/zh/quickstart/environment.html">环境准备</a></td></tr><tr><td>缺少 gd 扩展</td><td>验证码图片生成需要</td><td><a href="/zh/quickstart/environment.html">环境准备</a></td></tr><tr><td>Composer 安装慢</td><td>配置国内镜像</td><td><a href="/zh/quickstart/backend-start.html">后端启动</a></td></tr><tr><td>端口被占用</td><td>更换端口 <code>php think run --port 8080</code></td><td><a href="/zh/quickstart/backend-start.html">后端启动</a></td></tr><tr><td>数据库连接失败</td><td>检查 .env 配置</td><td><a href="/zh/quickstart/database-init.html">数据库初始化</a></td></tr><tr><td>pnpm install 失败</td><td>清除缓存重装</td><td><a href="/zh/quickstart/frontend-start.html">前端启动</a></td></tr></tbody></table><h2 id="认证与权限" tabindex="-1">认证与权限 <a class="header-anchor" href="#认证与权限" aria-label="Permalink to "认证与权限""></a></h2><table tabindex="0"><thead><tr><th>问题</th><th>说明</th><th>详细文档</th></tr></thead><tbody><tr><td>401 未授权</td><td>Token 缺失或过期</td><td><a href="/zh/core/jwt.html">JWT 认证</a></td></tr><tr><td>403 禁止访问</td><td>权限不足或租户异常</td><td><a href="/zh/core/rbac.html">RBAC 权限</a></td></tr><tr><td>Token 频繁过期</td><td>检查 JWT.ACCESS_TTL 配置</td><td><a href="/zh/core/jwt.html">JWT 认证</a></td></tr><tr><td>权限变更不生效</td><td>需重新登录</td><td><a href="/zh/core/rbac.html">RBAC 权限</a></td></tr><tr><td>菜单不显示</td><td>检查菜单配置和角色权限</td><td><a href="/zh/frontend/router.html">路由与菜单</a></td></tr></tbody></table><h2 id="业务功能" tabindex="-1">业务功能 <a class="header-anchor" href="#业务功能" aria-label="Permalink to "业务功能""></a></h2><table tabindex="0"><thead><tr><th>问题</th><th>说明</th><th>详细文档</th></tr></thead><tbody><tr><td>唯一性校验报错</td><td>数据重复，检查 uniqueFields</td><td><a href="/zh/guide/logic.html">逻辑层开发</a></td></tr><tr><td>枚举显示名为空</td><td>检查字典配置和 serializeMaps</td><td><a href="/zh/core/dict-guide.html">字典配置</a></td></tr><tr><td>文件上传失败</td><td>检查 FILE.UPLOAD_DIR 和目录权限</td><td><a href="/zh/tools/upload.html">文件上传</a></td></tr><tr><td>导入失败</td><td>检查 Excel 表头与 headerMap 一致</td><td><a href="/zh/tools/excel.html">导入导出</a></td></tr><tr><td>排序不生效</td><td>检查 pageOrderBy 配置</td><td><a href="/zh/guide/logic.html">逻辑层开发</a></td></tr><tr><td>富文本图片不显示</td><td>检查 FILE.DOMAIN_URL 配置</td><td><a href="/zh/tools/rich-text.html">富文本处理</a></td></tr></tbody></table><h2 id="前端开发" tabindex="-1">前端开发 <a class="header-anchor" href="#前端开发" aria-label="Permalink to "前端开发""></a></h2><table tabindex="0"><thead><tr><th>问题</th><th>说明</th><th>详细文档</th></tr></thead><tbody><tr><td>API 请求 404</td><td>检查后端路由和 Vite 代理</td><td><a href="/zh/frontend/http.html">HTTP 请求</a></td></tr><tr><td>白屏</td><td>打开 F12 控制台查看错误</td><td><a href="/zh/frontend/overview.html">前端概述</a></td></tr><tr><td>按钮权限不生效</td><td>检查 v-perm 指令和权限码</td><td><a href="/zh/frontend/permission.html">权限控制</a></td></tr><tr><td>动态路由不加载</td><td>检查菜单配置和组件路径</td><td><a href="/zh/frontend/router.html">路由与菜单</a></td></tr></tbody></table><h2 id="运维部署" tabindex="-1">运维部署 <a class="header-anchor" href="#运维部署" aria-label="Permalink to "运维部署""></a></h2><table tabindex="0"><thead><tr><th>问题</th><th>说明</th><th>详细文档</th></tr></thead><tbody><tr><td>502 Bad Gateway</td><td>PHP-FPM 未启动</td><td><a href="/zh/deploy/troubleshooting.html">故障排查</a></td></tr><tr><td>404 Not Found</td><td>Nginx URL 重写配置错误</td><td><a href="/zh/deploy/backend.html">后端部署</a></td></tr><tr><td>文件上传 413</td><td>Nginx client_max_body_size 限制</td><td><a href="/zh/deploy/backend.html">后端部署</a></td></tr><tr><td>OPcache 不生效</td><td>检查 php.ini 配置</td><td><a href="/zh/deploy/performance.html">性能调优</a></td></tr><tr><td>日志中 IP 为 127.0.0.1</td><td>部署在 CDN/代理后面时需配置 <code>PROXY_IPS</code></td><td><a href="/zh/deploy/backend.html">后端部署</a></td></tr><tr><td>IP 归属地为空</td><td>检查 <code>zoujingli/ip2region</code> 包是否安装</td><td><a href="/zh/deploy/backend.html">后端部署</a></td></tr></tbody></table><h2 id="代码生成器" tabindex="-1">代码生成器 <a class="header-anchor" href="#代码生成器" aria-label="Permalink to "代码生成器""></a></h2><table tabindex="0"><thead><tr><th>问题</th><th>说明</th><th>详细文档</th></tr></thead><tbody><tr><td>生成后页面不显示</td><td>菜单未创建或权限未分配</td><td><a href="/zh/generator/faq.html">代码生成器 FAQ</a></td></tr><tr><td>生成代码报错</td><td>模板语法或配置问题</td><td><a href="/zh/generator/faq.html">代码生成器 FAQ</a></td></tr><tr><td>表名不合法</td><td>只允许字母、数字、下划线</td><td><a href="/zh/generator/faq.html">代码生成器 FAQ</a></td></tr></tbody></table><h2 id="排查思路" tabindex="-1">排查思路 <a class="header-anchor" href="#排查思路" aria-label="Permalink to "排查思路""></a></h2><div class="tip custom-block"><p class="custom-block-title">排查步骤</p><p>遇到问题时，按以下顺序排查：</p><ol><li>查看 PHP 错误日志（Linux: <code>/var/log/php_errors.log</code>，XAMPP: <code>D:\\xampp\\php\\logs\\php_error_log</code>，路径可在 <code>php.ini</code> 的 <code>error_log</code> 配置项中确认）</li><li>查看浏览器 Network 面板（请求 URL、状态码、响应体）</li><li>检查 <code>.env</code> 配置（环境变量是否正确，注意 INI 分组格式）</li><li>检查 Redis/MySQL 连接（服务是否启动）</li><li>查阅对应模块的详细文档</li></ol></div>',16)])])}const f=d(h,[["render",o]]);export{b as __pageData,f as default};
|