fix: 处理部分情况下，postgres 数据库的兼容性问题；更新文档

Author: CaoMeiYouRen

docs/deploy.md

@@ -219,6 +219,10 @@ CACHE_CONTENT_EXPIRE=3600
 
 # 🗄️ 数据库配置
 
+注意：`SQLite` 数据库是优先支持的数据库（因为开发环境使用的是`SQLite`）。
+
+`MySQL`  和 `PostgreSQL` 数据库**不会**优先支持，可能存在兼容性问题。如果遇到此类问题，请提 [issue](https://github.com/CaoMeiYouRen/rss-impact-server/issues)。 
+
 ## 使用 SQLite 数据库
 
 无需特别配置
@@ -246,6 +250,8 @@ DATABASE_DATABASE='rss-impact'
 DATABASE_CHARSET='utf8_general_ci'
 # MySQL 服务器上配置的时区 （默认：local）
 DATABASE_TIMEZONE='local'
+# 带有 ssl 参数的对象
+DATABASE_SSL=false
 ```
 
 注意：首次连接时会创建数据表。在  `data/database.lock.json` 文件存在时不会同步数据表结构。
@@ -273,6 +279,8 @@ DATABASE_PASSWORD=postgres
 DATABASE_DATABASE=rss-impact
 # Postgre Schema 名称，默认是 "public".
 DATABASE_SCHEMA='public'
+# 带有 ssl 参数的对象
+DATABASE_SSL=false
 ```
 
 注意：首次连接时会创建数据表。在  `data/database.lock.json` 文件存在时不会同步数据表结构。

src/controllers/article/article.controller.ts

@@ -9,6 +9,7 @@ import { User } from '@/db/models/user.entity'
 import { CurrentUser } from '@/decorators/current-user.decorator'
 import { DicData } from '@/models/avue.dto'
 import { getConditions } from '@/utils/check'
+import { DATABASE_TYPE } from '@/app.config'
 
 @UseSession()
 @AclCrud({
@@ -46,12 +47,16 @@ export class ArticleController {
     @Get('typeDicData')
     async typeDicData(@CurrentUser() user: User) {
         const conditions = getConditions(user)
+        let enclosureType = 'enclosureType'
+        if (DATABASE_TYPE === 'postgres') {
+            enclosureType = '"enclosureType"'
+        }
         const data = await this.repository
             .createQueryBuilder('article')
             .where({
                 ...conditions,
             })
-            .select('enclosureType', 'type')// 选择要 distinct 的列
+            .select(enclosureType, 'type')// 选择要 distinct 的列
             .distinct(true) // 启用 distinct
             .getRawMany() as { type: string }[]
         return data.filter((e) => e.type).map((e) => ({

src/controllers/feed/feed.controller.ts

@@ -97,6 +97,7 @@ export class FeedController {
         }
         const rss = await rssParserURL(url)
         const { title, description, image } = rss || {}
+        // TODO 修复 postgres 数据库插入新数据时，bigserial 类型的 id 返回的是 string 类型
         const feed = await this.repository.save(this.repository.create({
             title,
             description: description || '',

src/db/database.module.ts

@@ -43,11 +43,12 @@ const SUPPORTED_DATABASE_TYPES = ['sqlite', 'mysql', 'postgres']
                 // 是否在每次应用程序启动时自动创建数据库架构。
                 let synchronize: boolean = false
                 switch (DATABASE_TYPE) {
-                    case 'sqlite':
+                    case 'sqlite': {
                         options = { database: DATABASE_PATH } as SqliteConnectionOptions //  数据库路径。
                         synchronize = true // 在数据库为 sqlite 的时候固定同步
                         break
-                    case 'mysql':
+                    }
+                    case 'mysql': {
                         options = {
                             host: DATABASE_HOST,
                             port: DATABASE_PORT,
@@ -71,7 +72,8 @@ const SUPPORTED_DATABASE_TYPES = ['sqlite', 'mysql', 'postgres']
                             synchronize = true
                         }
                         break
-                    case 'postgres':
+                    }
+                    case 'postgres': {
                         options = {
                             host: DATABASE_HOST,
                             port: DATABASE_PORT,
@@ -92,6 +94,7 @@ const SUPPORTED_DATABASE_TYPES = ['sqlite', 'mysql', 'postgres']
                             synchronize = true
                         }
                         break
+                    }
                     default:
                         break
                 }