Express访问/campgrounds/new报CastError ObjectId转换失败解决方法

使用Express + Mongoose开发Yelpie露营地项目时，访问/campgrounds/new路由持续抛出CastError异常，错误信息如下：

CastError: Cast to ObjectId failed for value "new" (type string) at path "_id" for model "Campground"

共有两个问题共同触发该报错：

• 路由路径书写错误：营地列表页、新建营地页两个路由的路径前缀错误添加了.，写成了./campgrounds开头的格式，Express无法正确匹配这两个路由，相当于这两个路由从未生效。
• 路由注册顺序逻辑错误：带动态参数:id的营地详情路由，优先级高于固定路径的新建营地路由。当请求到达/campgrounds/new时，Express会将路径中的new识别为:id的参数值，传入Campground.findById()方法，Mongoose尝试将字符串new转换为MongoDB要求的ObjectId类型，转换失败直接抛出类型转换错误。
• 额外隐性问题：原代码未引入path等依赖模块，运行时会触发模块未定义的报错。

1. 修正所有路由的路径格式，删除路径开头多余的.，所有路由路径统一以/开头。
2. 调整路由注册顺序，将所有固定路径的静态路由，放在带动态参数的同前缀路由之前，避免静态路径被动态路由拦截匹配。
3. 补全缺失的核心依赖引入语句。

修复后的完整核心代码如下：

const Campground = require('./models/campgrounds');
const path = require('path');
const mongoose = require('mongoose');
const express = require('express');

mongoose.connect('mongodb://localhost:27017/Yelpie');

const app = express();

app.set('view engine', 'ejs');
app.set('views', path.join(__dirname, 'views'));

app.get('/', (req, res) => {
    res.render('home');
});

// 修正路径格式，移除开头多余的.
app.get('/campgrounds', async (req, res) => {
    const campgrounds = await Campground.find({});
    res.render('./campgrounds/index', { campgrounds });
});

// 固定路径的new路由必须放在:id动态路由之前，同时修正路径格式
app.get('/campgrounds/new',  (req, res) => {
    res.render('./campgrounds/new');
});

// 动态参数路由放在同前缀静态路由之后
app.get('/campgrounds/:id', async(req, res) => {
    const campground = await Campground.findById(req.params.id);
    res.render('./campgrounds/show', { campground });
});

app.listen(3000, () => {
    console.log('Serving on port 3000');
});

修复完成后重启Node服务，再次访问/campgrounds/new即可正常渲染新建营地表单页，不会再触发CastError异常。

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