排查书籍显示问题

🔍 问题现象

前端页面显示"暂无推荐书籍"和"暂无畅销书籍"。

📋 可能原因

数据库中没有数据 - SQL脚本未执行
后端服务未启动 - API无法访问
API地址配置错误 - 前端无法连接到后端
数据库查询条件问题 - status字段可能不是1
数据格式问题 - 返回的数据格式不正确

✅ 排查步骤

步骤1：检查数据库是否有数据

在 Navicat 或 MySQL 命令行中执行：

USE books_db;

-- 检查books表中是否有数据
SELECT COUNT(*) as total FROM books;

-- 检查状态为1（上架）的书籍数量
SELECT COUNT(*) as total FROM books WHERE status = 1;

-- 查看所有书籍
SELECT id, title, status, created_at, read_count FROM books;

-- 查看今日推荐应该显示的书籍（最近创建的）
SELECT id, title, status, created_at 
FROM books 
WHERE status = 1 
ORDER BY created_at DESC 
LIMIT 8;

-- 查看畅销书籍应该显示的书籍（阅读量高的）
SELECT id, title, status, read_count, view_count 
FROM books 
WHERE status = 1 
ORDER BY read_count DESC, view_count DESC 
LIMIT 10;

如果查询结果为空，说明数据库中没有数据，需要执行SQL脚本。

步骤2：执行SQL脚本插入数据

方法1：在 Navicat 中执行

打开 Navicat
连接到 MySQL 数据库
选择 books_db 数据库
打开查询窗口
打开文件：book/src/main/resources/db/books_recommend_data.sql
复制所有内容
粘贴到查询窗口
执行 SQL 语句

方法2：使用命令行执行

mysql -u root -p books_db < book/src/main/resources/db/books_recommend_data.sql

步骤3：检查后端服务是否启动

检查后端服务：
```
cd book
mvn spring-boot:run
```
测试API接口：在浏览器中访问：
- 今日推荐：http://localhost:8081/api/book/today-recommend?limit=8
- 畅销书籍：http://localhost:8081/api/book/bestsellers?limit=10

或者使用 curl 测试：

   curl http://localhost:8081/api/book/today-recommend?limit=8
   curl http://localhost:8081/api/book/bestsellers?limit=10

期望返回：

   {
     "code": 200,
     "message": null,
     "data": [
       {
         "id": 1,
         "title": "西游记",
         ...
       }
     ]
   }

步骤4：检查前端API配置

检查 books/utils/config.js 文件：

const BASE_URL = config.BASE_URL

确认 BASE_URL 是否正确：

微信开发者工具：http://localhost:8081/api
真机调试：http://你的IP:8081/api

步骤5：检查网络请求

在微信开发者工具中：

打开 "调试器" -> "Network" 面板
刷新页面
查看是否有以下请求：
- GET /api/book/today-recommend?limit=8
- GET /api/book/bestsellers?limit=10
检查请求状态：
- 200：请求成功，查看响应数据
- 404：接口不存在，检查后端路由
- 500：服务器错误，查看后端日志
- 网络错误：检查后端服务是否启动

步骤6：检查后端日志

查看后端控制台输出，检查：

是否有SQL查询日志
是否有错误信息
返回的数据数量

🔧 快速修复

如果数据库中没有数据

执行以下SQL脚本（快速插入测试数据）：

USE books_db;

-- 插入今日推荐数据（8本）
INSERT INTO `books` (`title`, `author`, `cover`, `image`, `brief`, `desc`, `introduction`, `price`, `is_free`, `is_vip`, `category_id`, `status`, `view_count`, `like_count`, `read_count`, `created_at`, `updated_at`) VALUES
('西游记', '(明) 吴承恩', 'https://picsum.photos/seed/xiyouji/200/300', 'https://picsum.photos/seed/xiyouji/200/300', '《西游记》是中国古代第一部神魔题材的长篇章回小说', '中国古代第一部浪漫主义章回体长篇神魔小说', '本书《西游记》是中国古代第一部浪漫主义章回体长篇神魔小说', 0.00, 1, 0, 1, 1, 850, 120, 450, NOW(), NOW()),
('传习录:全译全注', '王阳明', 'https://picsum.photos/seed/chuanxilu/200/300', 'https://picsum.photos/seed/chuanxilu/200/300', '王阳明心学的核心著作', '王阳明心学的核心著作，阐述了知行合一的哲学思想', '传习录是王阳明心学的核心著作', 0.00, 1, 0, 1, 1, 620, 89, 320, NOW(), NOW()),
('社会契约论', '让·雅克·卢梭', 'https://picsum.photos/seed/shehuiqiyue/200/300', 'https://picsum.photos/seed/shehuiqiyue/200/300', '探讨了政治权力的合法性和人民主权的基本原则', '探讨了政治权力的合法性和人民主权的基本原则', '社会契约论是让·雅克·卢梭的重要政治哲学著作', 0.00, 1, 0, 1, 1, 480, 67, 280, NOW(), NOW()),
('没有烦恼的世界', '一行禅师', 'https://picsum.photos/seed/meiyoufan-nao/200/300', 'https://picsum.photos/seed/meiyoufan-nao/200/300', '一行禅师的心灵成长著作', '一行禅师的心灵成长著作，帮助读者摆脱烦恼', '《没有烦恼的世界》是一行禅师的心灵成长著作', 0.00, 1, 0, 1, 1, 390, 56, 210, NOW(), NOW()),
('透过电影看文化', '张艺谋', 'https://picsum.photos/seed/dianyingwenhua/200/300', 'https://picsum.photos/seed/dianyingwenhua/200/300', '通过电影作品探讨文化内涵', '通过电影作品探讨文化内涵和艺术表达', '《透过电影看文化》通过分析经典电影作品', 0.00, 1, 0, 1, 1, 320, 45, 180, NOW(), NOW()),
('车尔尼钢琴流畅练习曲', '卡尔·车尔尼', 'https://picsum.photos/seed/cheerni/200/300', 'https://picsum.photos/seed/cheerni/200/300', '钢琴练习经典教材', '钢琴练习经典教材，适合中级学习者', '《车尔尼钢琴流畅练习曲》是钢琴练习的经典教材', 0.00, 1, 0, 1, 1, 280, 38, 150, NOW(), NOW()),
('走向大洋', '余秋雨', 'https://picsum.photos/seed/zouxiangdayang/200/300', 'https://picsum.photos/seed/zouxiangdayang/200/300', '余秋雨的旅行散文集', '余秋雨的旅行散文集，记录了他的文化探索之旅', '《走向大洋》是余秋雨的旅行散文集', 0.00, 1, 0, 1, 1, 250, 34, 130, NOW(), NOW()),
('思维的艺术', '丹尼尔·卡尼曼', 'https://picsum.photos/seed/siweideyishu/200/300', 'https://picsum.photos/seed/siweideyishu/200/300', '探讨人类思维方式和决策过程', '探讨人类思维方式和决策过程', '《思维的艺术》是丹尼尔·卡尼曼的经典著作', 0.00, 1, 0, 1, 1, 220, 30, 110, NOW(), NOW());

-- 插入畅销书籍数据（10本，阅读量较高）
INSERT INTO `books` (`title`, `author`, `cover`, `image`, `brief`, `desc`, `introduction`, `price`, `is_free`, `is_vip`, `category_id`, `status`, `view_count`, `like_count`, `read_count`, `created_at`, `updated_at`) VALUES
('互联网心理学', '雷雳', 'https://picsum.photos/seed/hulianwangxinlixue/200/300', 'https://picsum.photos/seed/hulianwangxinlixue/200/300', '当连接万物的互联网遇见无处不在的心理学', '当连接万物的互联网遇见无处不在的心理学', '《互联网心理学》探讨了互联网时代人们的心理变化', 0.00, 1, 0, 1, 1, 5680, 890, 3450, DATE_SUB(NOW(), INTERVAL 30 DAY), NOW()),
('孝经 (中华经典诵读)', '孔子', 'https://picsum.photos/seed/xiaojing/200/300', 'https://picsum.photos/seed/xiaojing/200/300', '以孔子与其弟子曾参之间问答的形式', '以孔子与其弟子曾参之间问答的形式', '《孝经》是中国古代重要的儒家经典', 0.00, 1, 0, 1, 1, 4920, 756, 2980, DATE_SUB(NOW(), INTERVAL 25 DAY), NOW()),
('自省', '约翰·班扬', 'https://picsum.photos/seed/zixing/200/300', 'https://picsum.photos/seed/zixing/200/300', '讲述了敬虔之人和不敬虔之人截然相反的结局', '讲述了敬虔之人和不敬虔之人截然相反的结局', '《自省》是约翰·班扬的经典作品', 0.00, 1, 0, 1, 1, 4250, 634, 2670, DATE_SUB(NOW(), INTERVAL 20 DAY), NOW()),
('三体', '刘慈欣', 'https://picsum.photos/seed/santi/200/300', 'https://picsum.photos/seed/santi/200/300', '科幻小说，讲述了地球文明与三体文明', '科幻小说，讲述了地球文明与三体文明', '《三体》是刘慈欣创作的科幻小说', 29.90, 0, 0, 3, 1, 3680, 567, 2340, DATE_SUB(NOW(), INTERVAL 35 DAY), NOW()),
('理想国', '柏拉图', 'https://picsum.photos/seed/lixiangguo/200/300', 'https://picsum.photos/seed/lixiangguo/200/300', '古希腊哲学家柏拉图的经典著作', '古希腊哲学家柏拉图的经典著作', '《理想国》是古希腊哲学家柏拉图的经典著作', 0.00, 1, 1, 4, 1, 3120, 489, 1980, DATE_SUB(NOW(), INTERVAL 40 DAY), NOW()),
('红楼梦', '曹雪芹', 'https://picsum.photos/seed/hongloumeng/200/300', 'https://picsum.photos/seed/hongloumeng/200/300', '中国古典四大名著之一', '中国古典四大名著之一', '《红楼梦》是清代作家曹雪芹创作的长篇小说', 0.00, 1, 0, 1, 1, 2890, 456, 1780, DATE_SUB(NOW(), INTERVAL 45 DAY), NOW()),
('百年孤独', '加西亚·马尔克斯', 'https://picsum.photos/seed/bainiangudu/200/300', 'https://picsum.photos/seed/bainiangudu/200/300', '魔幻现实主义文学的代表作', '魔幻现实主义文学的代表作', '《百年孤独》是加西亚·马尔克斯的经典作品', 39.90, 0, 0, 1, 1, 2670, 423, 1650, DATE_SUB(NOW(), INTERVAL 50 DAY), NOW()),
('人类简史', '尤瓦尔·赫拉利', 'https://picsum.photos/seed/renleijianshi/200/300', 'https://picsum.photos/seed/renleijianshi/200/300', '从认知革命到科学革命', '从认知革命到科学革命', '《人类简史》是尤瓦尔·赫拉利的畅销作品', 49.90, 0, 0, 1, 1, 2450, 398, 1520, DATE_SUB(NOW(), INTERVAL 55 DAY), NOW()),
('活着', '余华', 'https://picsum.photos/seed/huozhe/200/300', 'https://picsum.photos/seed/huozhe/200/300', '余华的代表作', '余华的代表作，讲述了一个普通人的故事', '《活着》是余华的代表作', 0.00, 1, 0, 1, 1, 2230, 367, 1390, DATE_SUB(NOW(), INTERVAL 60 DAY), NOW()),
('围城', '钱钟书', 'https://picsum.photos/seed/weicheng/200/300', 'https://picsum.photos/seed/weicheng/200/300', '中国现代文学的经典之作', '中国现代文学的经典之作', '《围城》是钱钟书的经典作品', 0.00, 1, 0, 1, 1, 2010, 334, 1250, DATE_SUB(NOW(), INTERVAL 65 DAY), NOW());

如果后端服务未启动

cd book
mvn spring-boot:run

如果API地址配置错误

检查 books/utils/config.js：

// 确保BASE_URL正确
const BASE_URL = 'http://localhost:8081/api'

📝 验证清单

执行以下检查，确保一切正常：

数据库中有书籍数据（至少18本）
所有书籍的status字段为1（上架状态）
后端服务已启动（端口8081）
API接口可以访问（浏览器测试）
前端API地址配置正确
网络请求成功（Network面板查看）
返回数据格式正确（code=200，data不为空）

🎯 预期结果

执行完所有步骤后，应该看到：

数据库中有数据：

SELECT COUNT(*) FROM books WHERE status = 1;
-- 应该返回 >= 18

API接口返回数据：

curl http://localhost:8081/api/book/today-recommend?limit=8
# 应该返回JSON数据，包含8本书

前端页面显示书籍：
- "今日推荐"显示8本书
- "畅销书籍"显示10本书

创建时间：2024年 最后更新：2024年

排查书籍显示问题.md 11 KB Історія Запис