30 部署和优化之常见问题及解决方案

在进行 Express.js 应用程序的部署和优化过程中，开发人员可能会遇到各种问题。为了帮助您快速查找和解决这些问题，本节将总结一些常见的问题及其解决方案，确保您的应用程序能够顺利运行并具备良好的性能。

1. 应用程序启动失败

问题描述

在尝试启动 Express 应用时，控制台抛出错误信息。这可能是由于未安装依赖、环境变量配置错误或其他原因。

解决方案

• 检查依赖：确保您已运行 npm install 以安装所有必要的依赖。如果有更新的依赖，您也可以使用 npm update。

• 环境变量：确保所有必需的环境变量都已正确设置，特别是数据库连接字符串和端口号。

  export DATABASE_URL="your_database_url"
  export PORT=3000

• 查看错误日志：认真查看错误日志以获取有关错误的更多信息，尤其是堆栈跟踪部分。

2. 连接数据库失败

问题描述

在应用启动或运行时，连接数据库的无法建立，通常会显现为 ECONNREFUSED 或超时错误。

解决方案

• 确保数据库正在运行：检查数据库服务是否正在运行。例如，如果使用 MongoDB，可以使用以下命令：

  sudo systemctl status mongod

• 配置连接字符串：确保您使用的连接字符串是正确的，包括用户名、密码和数据库名。例如：

  const mongoose = require('mongoose');
  mongoose.connect(process.env.DATABASE_URL, { useNewUrlParser: true, useUnifiedTopology: true });

• 网络问题：如果数据库和应用在不同的主机上，请确保网络访问是打开且允许的。

3. 性能下降

问题描述

在高流量时段，应用程序响应时间增长显著。

解决方案

• 使用缓存：通过实现缓存策略（例如 Redis）来减少数据库查询次数。

  const redis = require('redis');
  const client = redis.createClient();
  
  app.get('/data', (req, res) => {
      client.get('someKey', (err, result) => {
          if (result) {
              res.send(result);
          } else {
              // 查询数据库
              db.query('SELECT ...', (dbErr, data) => {
                  client.setex('someKey', 3600, JSON.stringify(data)); // 缓存 1 小时
                  res.send(data);
              });
          }
      });
  });

• 使用负载均衡：通过多个实例部署应用程序，并使用负载均衡器（如 Nginx）来分发流量。

  upstream express_app {
      server app_instance1:3000;
      server app_instance2:3000;
  }
  
  server {
      listen 80;
      location / {
          proxy_pass http://express_app;
      }
  }

4. 跨域请求问题

问题描述

当前端与后端分离，且前端请求后端 API 时会出现跨域问题，浏览器控制台报错。

解决方案

• 使用 CORS 中间件：通过安装并配置 cors 中间件，可以简化跨域资源共享的处理。

  npm install cors

  const cors = require('cors');
  app.use(cors({
      origin: 'http://your-frontend-domain.com',
      methods: 'GET,HEAD,PUT,PATCH,POST,DELETE',
      credentials: true
  }));

5. 应用程序崩溃

问题描述

在某些情况下，Express 应用程序会意外崩溃，导致服务中断。

解决方案

• 使用进程管理工具：使用 PM2 或 forever 来管理 Node.js 进程，这样即使应用崩溃，也能自动重启。

  npm install pm2 -g
  pm2 start app.js --name "my-express-app"

• 捕获未处理的错误：在应用中捕获未处理的 Promise 拒绝和异常，以避免因未处理异常导致的进程崩溃。

  process.on('uncaughtException', function (err) {
      console.error('There was an uncaught error', err);
      // 进行必要的清理工作，例如关闭数据库连接
      process.exit(1); // 强制退出
  });
  
  process.on('unhandledRejection', (reason, promise) => {
      console.error('Unhandled Rejection at:', promise, 'reason:', reason);
  });

小结

在部署和优化 Express.js 应用程序时，20+在问题解决过程中保持清晰的思路至关重要。这里总结的常见问题及其解决方案，希望能为您提供帮助。接下来，我们将讨论如何进行高可用性部署，确保应用长期稳定运行。