Node.js Express访问本地端口报Failed to lookup view "index"错误

• Express集成Handlebars模板引擎时，默认在项目根目录的views文件夹下查找待渲染的模板文件。当前项目将index.handlebars模板存放在public静态资源目录中，且未配置模板引擎的实际查找路径，导致引擎只在空的views目录下检索文件，直接抛出视图查找失败错误。
• public目录仅用于映射纯静态资源的访问路径，Express默认不会将该目录纳入模板渲染的查找范围，即使手动创建views空目录，因为目录下无对应模板文件，报错会持续存在。

1. 调整项目目录结构
   将原本存放在public目录下的index.handlebars模板文件，移动到项目根目录下新建的views文件夹中。

目录拆分规则：public目录仅存放CSS、JavaScript、图片等无需服务端编译的纯静态文件，模板文件统一放置在views目录下。
调整后的标准项目结构参考：

contact-form/
├── server.js
├── package.json
├── node_modules/
├── views/
│   └── index.handlebars
└── public/
    ├── css/
    ├── js/
    └── images/

2. 补全视图路径配置
   在服务端代码的视图引擎初始化段，添加显式指定视图根目录的配置，修正后的代码段：

// View engine setup
app.engine('handlebars', exphbs());
// 新增配置：指定模板文件的实际存放路径
app.set('views', path.join(__dirname, 'views'));
app.set('view engine', 'handlebars');

3. 修正静态资源引用路径
   调整index.handlebars内的静态资源引用，确保路径和express.static的映射规则匹配，示例：

<!-- 正确引用public目录下静态资源的写法 -->
<link rel="stylesheet" href="/public/css/main.css">
<script src="/public/js/main.js"></script>

• 确认views/index.handlebars文件命名完全匹配：注意Windows系统默认隐藏文件扩展名，避免出现实际文件名为index.handlebars.txt这类隐藏扩展名导致的匹配失败
• 确认依赖安装完整：在项目根目录执行npm install确保所有依赖包正确安装
• 当前使用的Node.js v14.16.0版本，与项目依赖的Express 4.17.1、express-handlebars 5.3.0版本完全兼容，无需升级版本即可正常运行

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