Node.js Express博客开发报错：Article.findById is not a function

核心问题梳理 #

你的代码存在多个关键错误，直接导致了findById方法不存在的报错：

1. 模型导入与使用错误：你导入的Article应该是自定义的Mongoose模型，但当前代码里误用了Mongoose库类来创建实例，且导入的模型路径/导出可能不正确。
2. 异步方法未正确处理：findById是异步方法，未用await或.then()处理，且传入了多余的参数。
3. 语法细节错误：模板字符串使用单引号、save方法未加执行括号、重定向路径格式错误等。

第一步：确保模型文件正确 #

先检查你的./../models/mongoose.js（建议重命名为article.js更清晰），必须正确定义并导出Mongoose模型，示例如下：

const mongoose = require('mongoose');

// 定义文章数据结构
const articleSchema = new mongoose.Schema({
  title: String,
  description: String,
  markdown: String
});

// 导出模型类，这是拥有findById等方法的核心
module.exports = mongoose.model('Article', articleSchema);

修正后的路由代码 #

const express = require('express');
const Article = require('./../models/article'); // 导入正确的模型文件
const router = express.Router(); // 用Router创建模块化路由，而非express()

router.get('/new', (req, res) => {
    res.render('articles/new', { article: new Article() }); // 使用自定义模型创建实例
});
 
router.get('/', (req, res) => {
    res.render('index');
});
 
router.get('/:id', async (req, res) => {
    try {
        // findById仅需传入id参数，用await处理异步查询
        const article = await Article.findById(req.params.id);
        if (!article) {
            return res.status(404).send('文章不存在');
        }
        res.send(`${req.params.id}`); // 模板字符串用反引号
    } catch (err) {
        console.error(err);
        res.status(500).send('获取文章失败');
    }
});
 
router.post('/', async (req, res) => {
    let article = new Article({ 
        title: req.body.title, 
        description: req.body.description, 
        markdown: req.body.markdown 
    });

    try {
        article = await article.save(); // save()需加括号执行
        res.redirect(`/articles/${article.id}`); // 重定向路径无需冒号，用模板字符串
    } catch(e) {
        console.log(e);
        res.render('articles/new', { article: article });
    }
});

module.exports = router;

关键知识点说明 #

• Article.findById()的作用：这是Mongoose模型内置的静态方法，专门用于通过MongoDB文档自动生成的_id字段，查询单条匹配的文档。它返回Promise，必须用await或.then()处理才能拿到实际的文档数据。
• 模型的正确声明：只有通过mongoose.model('模型名', 数据模式)创建并导出的类，才会继承Mongoose的所有静态方法（如findById、find、create等），直接使用Mongoose库类无法实现数据操作。

内容的提问来源于stack exchange，提问作者Kalyan Sundar