TypeScript+Express配置：端口权限拒绝问题排查与解决

可能成因 #

• 系统安全规则限制：SELinux、AppArmor等工具可能拦截Node.js进程绑定网络端口，哪怕是5000这类高位端口。
• Node.js进程权限不足：当前运行npm的用户没有创建网络套接字的足够权限，或系统对Node.js进程做了权限约束。
• 端口资源异常：看似更换了端口，但系统端口资源耗尽，或代码存在端口复用逻辑错误。
• TypeScript工具权限问题：ts-node或编译后的JS文件权限异常，导致进程启动时受阻。

解决方法 #

1. 临时提升权限排查 #

执行以下命令临时用root权限启动服务，验证是否为用户权限问题：

sudo npm run dev

注：生产环境禁止直接用root运行Node.js服务。

2. 给Node.js添加端口绑定权限（Linux） #

执行命令赋予Node.js绑定任意端口的权限，无需root：

sudo setcap 'cap_net_bind_service=+ep' $(which node)

3. 排查端口占用与系统限制 #

• 检查指定端口是否被占用（以5000为例）：

lsof -i :5000
# 或
netstat -tulpn | grep :5000

若有进程占用，用kill -9 <进程PID>杀掉后重试。

• 查看系统可用端口范围：

sysctl net.ipv4.ip_local_port_range

确保使用的端口在输出的区间内，若不在需调整系统配置。

4. 检查TypeScript配置与文件权限 #

• 查看package.json的dev脚本，确认端口配置无误，未误使用1-1023的低端口。
• 确保当前用户对项目目录、编译输出文件夹（如dist）有读写权限：

chown -R $USER:$USER ./

• 绕过ts-node直接运行编译后的文件：先执行tsc编译，再用node dist/server.js启动，排查工具层面的权限问题。

5. 排查系统安全规则 #

• 临时关闭SELinux测试：

sudo setenforce 0

若关闭后服务正常启动，需修改SELinux规则允许Node.js绑定端口。

• 检查AppArmor配置（Ubuntu等系统），确认是否存在限制Node.js的规则。

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