TypeORM连接PostgreSQL报client password must be a string错误如何解决

报错SASL: SCRAM-SERVER-FIRST-MESSAGE: client password must be a string的核心原因是传给PostgreSQL驱动的password参数不是字符串类型，实际值为undefined，和TypeORM本身逻辑无关，是代码执行顺序导致dotenv加载时机晚于环境变量读取：
ES模块的依赖解析是深度优先执行的，所有被依赖模块的顶层代码会优先于依赖方的代码执行，和你写的import语句先后顺序没有绝对关系。你的代码逻辑存在以下问题：

1. dotenv.config()写在Express应用入口app.ts的顶层，不是整个应用最早执行的逻辑
2. 路由、控制器层存在对数据库配置AppDataSource的间接依赖，模块解析时会优先加载数据库配置文件，执行顶层的new DataSource({...})逻辑读取process.env上的数据库配置
3. 等执行到dotenv.config()把.env文件的配置注入到process.env时，DataSource早就用undefined值完成了配置初始化，驱动收到非字符串的密码就抛出了对应错误。
   之前能正常运行只是模块解析顺序刚好巧合让dotenv提前执行了，只要调整过文件导入顺序、新增了对数据库配置的间接依赖、或者运行时/打包工具处理模块的顺序变了，就会触发这个问题。

1. 把dotenv初始化放到应用最顶层执行 #

把dotenv的加载逻辑移到服务启动文件的最顶部，保证在导入任何需要读取环境变量的模块（包括app、路由、数据库配置）之前就完成.env加载。
修改后的服务启动文件代码：

// 第一行就加载dotenv，不要放在任何其他import后面
import dotenv from 'dotenv';
dotenv.config();

// 等dotenv加载完再导入其他依赖
import app from './app';
import { AppDataSource } from './src/database/Config';

async function connection() {
    const port = process.env.PORT;
    try {
        await AppDataSource.initialize();
        console.log('Database connected! ');
        app.listen(port);
        console.log(`Listening on port ${port}`)
    } catch (error) {
        console.log(error);
    }
}

connection();

同时把app.ts里的dotenv.config()删掉，避免重复执行。

2. 增加环境变量校验（可选但推荐） #

在数据库配置里增加必填环境变量的校验，避免后续再出现类似undefined传参的问题，修改数据库配置文件：

import { DataSource } from "typeorm"
import { User } from "../entities/User"

// 启动时直接校验必填配置，缺了立刻抛出明确错误
const requiredEnvVars = ['DATABASE_HOST', 'DATABASE_USERNAME', 'DATABASE_PASSWORD', 'DATABASE_NAME'] as const;
for (const envVar of requiredEnvVars) {
    if (!process.env[envVar]) {
        throw new Error(`Missing required environment variable: ${envVar}`);
    }
}

export const AppDataSource = new DataSource({
    type: "postgres",
    host: process.env.DATABASE_HOST,
    port: 5432,
    username: process.env.DATABASE_USERNAME,
    password: process.env.DATABASE_PASSWORD,
    database: process.env.DATABASE_NAME,
    synchronize: true,
    logging: true,
    entities: [User],
    subscribers: [],
    migrations: [],
})

改完重启服务即可正常连接数据库。

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