Docker部署Express应用时报app.set is not a function错误怎么解决？

问题根因 #

你本地执行的是node app.js直接启动服务，但Docker配置中指定的启动命令是npm start，两者启动入口不一致是报错的核心原因。
大多数Express初始化项目的默认npm start脚本会调用./bin/www文件，该文件会导入app.js导出的express实例，调用app.set方法设置端口等配置。如果你的app.js没有正确导出express实例，或者直接在app.js内执行了app.listen，就会导致bin/www拿到的app变量不符合预期，触发app.set is not a function报错。

解决方法 #

你可以任选以下一种方案修复：

方案1：对齐本地启动逻辑（最简单快速） #

直接修改docker-compose.yml中的启动命令，替换为你本地验证过的启动方式：
把command: "npm start"修改为command: "node app.js"即可。

方案2：适配npm start启动逻辑 #

如果你需要保留npm start作为启动命令，按以下步骤调整：

• 首先检查项目package.json的scripts字段，确认start对应的启动脚本为node ./bin/www
• 删掉app.js中app.listen(80, () => console.log("Listening on port 80"));这行代码，端口监听逻辑统一交给bin/www处理
• 在app.js文件末尾添加module.exports = app，将express实例导出给bin/www调用
• 可按需修改bin/www中的默认监听端口为80，或者通过环境变量动态传入端口

额外注意事项 #

如果你是直接把本地开发环境的node_modules文件夹通过scp传到了服务器，本地如果是Windows/macOS系统，部分依赖的二进制文件和Alpine Linux系统不兼容，可能会引发其他运行报错。建议删除服务器上的node_modules文件夹，在容器启动时先执行npm install重新安装适配系统的依赖，比如把启动命令调整为command: sh -c "npm install && node app.js"。

内容的提问来源于stack exchange，提问作者J. Doe