166 lines
3.9 KiB
Markdown
166 lines
3.9 KiB
Markdown
|
# pages.json配置错误修复说明 - 2026-02-01
|
|||
|
|
|
|||
|
|
## 问题描述
|
|||
|
|
|
|||
|
|
小程序编译时报错：
|
|||
|
|
```
|
|||
|
|
app.json 文件内容错误: app.json: 未找到 ["subPackages"][7]["pages"][0] 对应的 activity-package/pages/course/detail.wxml 文件
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 根本原因
|
|||
|
|
|
|||
|
|
`pages.json` 中 `activity-package` 分包配置了一个不存在的页面路径：
|
|||
|
|
|
|||
|
|
**错误配置**:
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"root": "activity-package",
|
|||
|
|
"name": "activity",
|
|||
|
|
"pages": [
|
|||
|
|
{
|
|||
|
|
"path": "pages/course/detail", // ❌ 错误：这个路径不存在
|
|||
|
|
"style": {
|
|||
|
|
"navigationBarTitleText": "课程详情"
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
]
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**实际目录结构**:
|
|||
|
|
```
|
|||
|
|
activity-package/
|
|||
|
|
├── pages/
|
|||
|
|
│ ├── academy/
|
|||
|
|
│ │ ├── course-detail.vue ✅ 正确的文件
|
|||
|
|
│ │ ├── detail.vue
|
|||
|
|
│ │ └── index.vue
|
|||
|
|
│ ├── activity/
|
|||
|
|
│ ├── camp/
|
|||
|
|
│ ├── growth/
|
|||
|
|
│ ├── interest/
|
|||
|
|
│ ├── study-tour/
|
|||
|
|
│ └── supervision/
|
|||
|
|
└── static/
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
`activity-package` 中没有 `course` 目录，只有 `academy` 目录，课程详情页面是 `academy/course-detail.vue`。
|
|||
|
|
|
|||
|
|
## 修复方案
|
|||
|
|
|
|||
|
|
修改 `pages.json` 中的路径配置：
|
|||
|
|
|
|||
|
|
**修复后的配置**:
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"root": "activity-package",
|
|||
|
|
"name": "activity",
|
|||
|
|
"pages": [
|
|||
|
|
{
|
|||
|
|
"path": "pages/academy/course-detail", // ✅ 正确路径
|
|||
|
|
"style": {
|
|||
|
|
"navigationBarTitleText": "课程详情"
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
]
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 修复步骤
|
|||
|
|
|
|||
|
|
### 1. 修改配置文件 ✅
|
|||
|
|
|
|||
|
|
已修改 `peidu/uniapp/src/pages.json` 文件
|
|||
|
|
|
|||
|
|
### 2. 清除编译缓存
|
|||
|
|
|
|||
|
|
**方式1：在微信开发者工具中**
|
|||
|
|
1. 点击菜单栏"工具" → "清除缓存"
|
|||
|
|
2. 选择"清除数据缓存"和"清除文件缓存"
|
|||
|
|
3. 点击"清除"按钮
|
|||
|
|
|
|||
|
|
**方式2：手动删除（需要先关闭微信开发者工具）**
|
|||
|
|
1. 关闭微信开发者工具
|
|||
|
|
2. 删除以下目录：
|
|||
|
|
- `peidu/uniapp/dist`
|
|||
|
|
- `peidu/uniapp/unpackage`
|
|||
|
|
- `peidu/uniapp/node_modules/.cache`
|
|||
|
|
|
|||
|
|
### 3. 重新编译
|
|||
|
|
|
|||
|
|
在微信开发者工具中点击"编译"按钮
|
|||
|
|
|
|||
|
|
## 注意事项
|
|||
|
|
|
|||
|
|
1. **清除缓存前必须关闭微信开发者工具**
|
|||
|
|
- 如果工具正在运行，文件会被占用，无法删除
|
|||
|
|
|
|||
|
|
2. **确保后端服务已启动**
|
|||
|
|
- 端口8089应该可用
|
|||
|
|
- 如果被占用，先停止旧进程
|
|||
|
|
|
|||
|
|
3. **游客模式配置已完成**
|
|||
|
|
- 后端已添加所有公开接口到白名单
|
|||
|
|
- 前端已配置游客模式逻辑
|
|||
|
|
|
|||
|
|
## 完整的修复流程
|
|||
|
|
|
|||
|
|
### 步骤1：修复pages.json配置 ✅
|
|||
|
|
已完成
|
|||
|
|
|
|||
|
|
### 步骤2：重启后端服务
|
|||
|
|
```bash
|
|||
|
|
# 查找占用8089端口的进程
|
|||
|
|
netstat -ano | findstr :8089
|
|||
|
|
|
|||
|
|
# 停止进程
|
|||
|
|
taskkill /F /PID <PID>
|
|||
|
|
|
|||
|
|
# 在IDEA中重新启动 PeiduApplication
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 步骤3：清除前端缓存并重新编译
|
|||
|
|
```bash
|
|||
|
|
# 关闭微信开发者工具
|
|||
|
|
|
|||
|
|
# 删除缓存目录
|
|||
|
|
cd peidu/uniapp
|
|||
|
|
rmdir /s /q dist
|
|||
|
|
rmdir /s /q unpackage
|
|||
|
|
rmdir /s /q node_modules\.cache
|
|||
|
|
|
|||
|
|
# 重新打开微信开发者工具并编译
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 测试验证
|
|||
|
|
|
|||
|
|
编译成功后，测试以下功能：
|
|||
|
|
|
|||
|
|
### 1. 游客模式测试
|
|||
|
|
- [ ] 专项突破列表显示正常
|
|||
|
|
- [ ] 兴趣培养列表显示正常
|
|||
|
|
- [ ] 测评师列表显示正常
|
|||
|
|
- [ ] 成长规划师列表显示正常
|
|||
|
|
- [ ] 课程详情页显示正常
|
|||
|
|
|
|||
|
|
### 2. 登录拦截测试
|
|||
|
|
- [ ] 点击"立即预约"提示登录
|
|||
|
|
- [ ] 点击"立即购买"提示登录
|
|||
|
|
- [ ] 登录后可以正常预约和购买
|
|||
|
|
|
|||
|
|
## 涉及的文件
|
|||
|
|
|
|||
|
|
### 修改的文件
|
|||
|
|
- `peidu/uniapp/src/pages.json` - 修复了activity-package的页面路径配置
|
|||
|
|
|
|||
|
|
### 相关文件
|
|||
|
|
- `peidu/uniapp/src/activity-package/pages/academy/course-detail.vue` - 实际的课程详情页面
|
|||
|
|
- `peidu/backend/src/main/java/com/peidu/config/WebMvcConfig.java` - 后端游客模式配置
|
|||
|
|
- `peidu/uniapp/src/utils/request.js` - 前端游客模式配置
|
|||
|
|
|
|||
|
|
## 总结
|
|||
|
|
|
|||
|
|
这是一个配置错误，`pages.json` 中配置的页面路径与实际文件路径不匹配。修复后需要清除编译缓存并重新编译才能生效。
|
|||
|
|
|
|||
|
|
同时，游客模式的后端和前端配置都已完成，重新编译后应该可以正常工作。
|