AIclinicalresearch/docs/03-业务模块/Redcap/01-部署与配置/13-部署问题排查手册.md

REDCap Docker <20>砍𧑐<E7A08D>函蔡<E587BD>桅<EFBFBD>閫<EFBFBD><E996AB>霈啣<E99C88>

*<EFBFBD>交<EFBFBD>嚗? 2026-01-02
*<EFBFBD><EFBFBD>𧋦嚗? REDCap 15.8.0
*<EFBFBD>臬<EFBFBD>嚗? Windows 10 + Docker Desktop + Docker Compose

---

<EFBFBD><EFBFBD> <20>函蔡<E587BD>𣂼<EFBFBD>蝖株恕

<EFBFBD>?REDCap 15.8.0 撌脫<E6928C><E884AB>罸<EFBFBD>蝵脣銁<E884A3>砍𧑐Docker<65>臬<EFBFBD>

• *霈輸䔮<EFBFBD>啣<EFBFBD>嚗? http://localhost:8080/
• 蝞∠<EFBFBD><EFBFBD>䁅揭<EFBFBD>瘀<EFBFBD> Admin / Admin123!
• <EFBFBD>唳旿摨橒<EFBFBD> MySQL 8.0嚗㇄ocker摰孵膥嚗?
• *PHPMyAdmin嚗? http://localhost:8081/

---

<EFBFBD><EFBFBD> <20><><EFBFBD><EFBFBD><EFBFBD>䔮憸睃<E686B8>閫<EFBFBD><E996AB><EFBFBD>寞<EFBFBD>

<EFBFBD>桅<EFBFBD>1嚗鍃RR_CONTENT_DECODING_FAILED

*<EFBFBD>啗情嚗?

• 瘚讛<EFBFBD><EFBFBD>刻挪<EFBFBD>娜EDCap擐㚚△<EFBFBD>嗆𥁒<EFBFBD>辷<EFBFBD>net::ERR_CONTENT_DECODING_FAILED 200 (OK)
• CSS/JS韏<53><E99F8F><EFBFBD>㰘蝸憭梯揖

*<EFBFBD>寞𧋦<EFBFBD>笔<EFBFBD>嚗?

1. Apache<EFBFBD><EFBFBD>mod_deflate璅∪<EFBFBD>銝窰HP<EFBFBD><EFBFBD>zlib.output_compression<EFBFBD>脩<EFBFBD>
2. REDCap皞鞟<EFBFBD>銝剖𢆡<EFBFBD><EFBFBD>鍳<EFBFBD>其<EFBFBD><EFBFBD>讠憬嚗ǑSystem.php<EFBFBD><EFBFBD>general_settings.php銝剔<EFBFBD>ini_set嚗?
3. 撖潸稲<EFBFBD>唳旿鋡怠<EFBFBD>甈∪<EFBFBD>蝻抬<EFBFBD>瘚讛<EFBFBD><EFBFBD>冽<EFBFBD>瘜閗圾<EFBFBD>?

*閫<EFBFBD><EFBFBD><EFBFBD>寞<EFBFBD>嚗?

1. <EFBFBD>?<3F>灼docker-entrypoint.sh銝剖撩<EFBFBD>嗥<EFBFBD><EFBFBD>杗pache<EFBFBD><EFBFBD>eflate璅∪<EFBFBD>嚗䫤a2dismod -f deflate
2. <EFBFBD>?<3F>灼php.ini`銝剜遬撘誩<E69298><E8AAA9>剖<EFBFBD>蝻抬<E89DBB>

   zlib.output_compression = Off
   output_buffering = Off
   

3. <EFBFBD>?<3F>灼docker-entrypoint.sh銝剛䌊<EFBFBD>冽釣<EFBFBD>䟕EDCap皞鞟<EFBFBD>銝剔<EFBFBD>ini_set('zlib.output_compression', ...)`

*憸<EFBFBD>俈<EFBFBD>芣鴌嚗?

• 撌脣銁redcap.conf銝剜釣<EFBFBD>𦠜<EFBFBD>mod_deflate<EFBFBD>滨蔭
• 撘<EFBFBD><EFBFBD>𤑳㴓憓<EFBFBD><EFBFBD><EFBFBD><EFBFBD>閬<EFBFBD>zip<EFBFBD>讠憬嚗<EFBFBD>虾<EFBFBD>鞾<EFBFBD>靚<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>

---

<EFBFBD>桅<EFBFBD>2嚗鋳ase URL<52>滨蔭<E6BBA8>躰秤

*<EFBFBD>啗情嚗?

• CSS/JS<4A><53>辣頝臬<E9A09D><E887AC><EFBFBD>鉄憭帋<E686AD><E5B88B><EFBFBD>/redcap/`<60>滨<EFBFBD>
• 靘见<EFBFBD>嚗䫤http://localhost:8080/redcap/redcap_v15.8.0/Resources/...`
• 撖潸稲404<EFBFBD>躰秤

*<EFBFBD>寞𧋦<EFBFBD>笔<EFBFBD>嚗?

• REDCap<EFBFBD>唳旿摨㯄<EFBFBD>蝵株”redcap_config銝剔<EFBFBD>redcap_base_url霈曄蔭銝槁http://localhost:8080/redcap`
• 雿<EFBFBD>pache<EFBFBD><EFBFBD>DocumentRoot摰鮋<EFBFBD><EFBFBD><EFBFBD><EFBFBD>/var/www/html/redcap_v15.8.0`

*閫<EFBFBD><EFBFBD><EFBFBD>寞<EFBFBD>嚗?

UPDATE redcap_config 
SET value = 'http://localhost:8080' 
WHERE field_name = 'redcap_base_url';

*憸<EFBFBD>俈<EFBFBD>芣鴌嚗?

• <EFBFBD>典<EFBFBD>鋆<EFBFBD><EFBFBD>撖潭<EFBFBD>SQL撖澆<EFBFBD><EFBFBD>嗥＆靽𨈚ase URL銝𥟠ocumentRoot銝<74><E98A9D>?

---

<EFBFBD>桅<EFBFBD>3嚗𡁶蒈敶訫仃韐?- <20>滚<EFBFBD><E6BB9A>唳旿<E594B3>䭾<EFBFBD><E4ADBE>㰘蝸

*<EFBFBD>啗情嚗?

• 颲枏<EFBFBD>甇<EFBFBD>＆<EFBFBD><EFBFBD>鍂<EFBFBD>瑕<EFBFBD>撖<EFBFBD><EFBFBD><EFBFBD>𠬍<EFBFBD>憿菟𢒰銝滩歲頧?
• Network<EFBFBD>Ｘ踎<EFBFBD>曄內POST霂瑟<EFBFBD>餈𥪜<EFBFBD>200嚗䔶<EFBFBD>"<22>䭾<EFBFBD><E4ADBE>㰘蝸<E3B098>滚<EFBFBD><E6BB9A>唳旿"

*<EFBFBD>寞𧋦<EFBFBD>笔<EFBFBD>嚗?

• *database.php<EFBFBD><EFBFBD>辣<EFBFBD>怠偏<EFBFBD>头?>`PHP蝏𤘪<E89D8F><F0A498AA><EFBFBD>倌<EFBFBD>𣬚征銵?
• Windows蝟餌<EFBFBD><EFBFBD><EFBFBD>RLF<EFBFBD>Ｚ<EFBFBD>蝚西◤颲枏枂<EFBFBD>蚜TTP<EFBFBD>滚<EFBFBD>
• 撖潸稲<EFBFBD>滚<EFBFBD>雿𤘪情<EFBFBD>橒<EFBFBD>瘚讛<EFBFBD><EFBFBD>冽<EFBFBD>瘜閗圾<EFBFBD>?

*霂衣<EFBFBD><EFBFBD><EFBFBD><EFBFBD>嚗?

# database.php<68>怠偏<E680A0><E5818F><EFBFBD><EFBFBD>剛<EFBFBD><E5899B>嗅<EFBFBD>摰?
00000050: e585 a80d 0a20 2a2f 0d0a 0d0a 3f3e 0d0a  ..... */....?>..
00000060: 0d0a 0d0a                                ....
        # `*/`  CRLF  CRLF  `?>`  CRLF  CRLF  CRLF

*閫<EFBFBD><EFBFBD><EFBFBD>寞<EFBFBD>嚗?

1. <EFBFBD>?**<2A>𣳇膄database.php<EFBFBD>怠偏<EFBFBD><EFBFBD>?>`<60>峕<EFBFBD><E5B395>厩征銵?*
2. <EFBFBD>?**<2A>𥕦遣.gitattributes撘箏<EFBFBD>PHP<EFBFBD><EFBFBD>辣雿輻鍂LF<EFBFBD>Ｚ<EFBFBD>蝚?*
3. <EFBFBD>?<EFBFBD>灼docker-entrypoint.sh`銝剜溶<E5899C>䭾<EFBFBD><E4ADBE>仿<EFBFBD>餉<EFBFBD>嚗<EFBFBD>郎<EFBFBD>𦠜<EFBFBD>蝷綽<E89DB7>

PHP<EFBFBD><EFBFBD>雿喳<EFBFBD>頝蛛<EFBFBD>

• <EFBFBD><EFBFBD> <EFBFBD>滨蔭<EFBFBD><EFBFBD>辣<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>辣<EFBFBD>怠偏銝滚<EFBFBD>霂亙<EFBFBD>?>
• <EFBFBD><EFBFBD> 餈蹱糓PHP摰䀹䲮<E480B9>刻<EFBFBD>嚗𣬚鍂鈭𡡞俈甇Ｘ錰撠曄征銵峕情<E5B395>栞<EFBFBD><E6A09E>?
• <EFBFBD><EFBFBD> REDCap摰䀹䲮皞鞟<E79A9E><E99E9F>賡<EFBFBD>敺芣迨閫<E8BFA8><E996AB>

---

<EFBFBD><EFBFBD> 摰匧<E691B0><E58CA7>芣鴌

撖<EFBFBD><EFBFBD><EFBFBD>滨蔭撌亙<EFBFBD>

<EFBFBD>𥕦遣鈭<EFBFBD>scripts/create-redcap-password.php`嚗𣬚鍂鈭𡡞<E988AD>蝵娜EDCap<61>冽<EFBFBD>撖<EFBFBD><E69296>嚗?

# 雿輻鍂<E8BCBB>寞<EFBFBD>
docker cp scripts/create-redcap-password.php redcap-apache:/tmp/
docker exec redcap-apache php /tmp/create-redcap-password.php

*瘜冽<EFBFBD>嚗? 甇方<E79487><E696B9>砌<EFBFBD><E7A08C>其<EFBFBD>撘<EFBFBD><E69298>𤑳㴓憓<E3B493><E68693><EFBFBD>煺漣<E785BA>臬<EFBFBD>摨𠉛<E691A8><F0A0899B>具<EFBFBD>?

---

<EFBFBD>?<3F><>蝏<EFBFBD>＆霈?

REDCap蝟餌<EFBFBD><EFBFBD>臬<EFBFBD><EFBFBD>函<EFBFBD>

*<EFBFBD>滩<EFBFBD>蝏栞捏嚗?

1. <EFBFBD>?REDCap摰䀹䲮皞鞟<EFBFBD>嚗?5.8.0<EFBFBD><EFBFBD>𧋦嚗峕㺭<EFBFBD><EFBFBD>葵PHP<EFBFBD><EFBFBD>辣嚗厰<EFBFBD><EFBFBD>航<EFBFBD><EFBFBD><EFBFBD><EFBFBD>
2. <EFBFBD>?摰䀹䲮<EFBFBD><EFBFBD>辣<EFBFBD>怠偏<EFBFBD>賣瓷<EFBFBD>头?>`嚗䔶<E59A97>摮睃銁CRLF瘙⊥<E79899><E28AA5>桅<EFBFBD>
3. <EFBFBD>?<EFBFBD>桅<EFBFBD>隞<EFBFBD><EFBFBD><EFBFBD>其<EFBFBD><EFBFBD>睲賑<EFBFBD>𥕦遣<EFBFBD><EFBFBD><EFBFBD>蝵格<EFBFBD>隞跆database.php`
4. <EFBFBD>?*銝<EFBFBD><EFBFBD>虫耨憭㵪<EFBFBD>銝滢<EFBFBD><EFBFBD>匧<EFBFBD>隞𣇉掩隡潮䔮憸?

*撉諹<EFBFBD>霂<EFBFBD>旿嚗?

# REDCap摰䀹䲮index.php<68>怠偏嚗<E5818F><E59A97><EFBFBD><EFBFBD><EFBFBD>
tail -c 20 /var/www/html/redcap/redcap_v15.8.0/index.php | xxd
00000000: 656e 6572 616c 2f66 6f6f 7465 722e 7068  eneral/footer.ph
00000010: 7027 3b0a                                p';.
# <20>怠偏<E680A0>芣<EFBFBD> '; <20>峕揢銵𣬚泵嚗峕瓷<E5B395>?>

# REDCap摰䀹䲮Authentication.php<68>怠偏嚗<E5818F><E59A97><EFBFBD><EFBFBD><EFBFBD>
tail -c 30 /var/www/html/redcap/redcap_v15.8.0/Classes/Authentication.php | xxd
00000000: 6c2c 205b 2475 7365 7269 645d 2929 203e  l, [$userid])) >
00000010: 2030 3b0a 0909 7d0a 097d 0a0a 7d0a        0;...}..}..}.
# <20>怠偏<E680A0>芣<EFBFBD> } <20>峕揢銵𣬚泵嚗峕瓷<E5B395>?>

---

<EFBFBD><EFBFBD> 蝏誯<E89D8F><E8AAAF>餌<EFBFBD>

1. Docker頝典像<E585B8>唳釣<E594B3>譍<EFBFBD>憿?

Windows + Docker + Linux摰孵膥蝏<E886A5><E89D8F>隡𡁏𠂔<F0A1818F>脫<EFBFBD>隞嗆聢撘誯䔮憸矋<E686B8>

• Windows暺䁅恕CRLF (\r\n)
• Linux暺䁅恕LF (\n)
• Git<EFBFBD><EFBFBD>autocrlf`霈曄蔭<E69B84>航<EFBFBD><E888AA>芸𢆡頧祆揢
• 雿輻鍂.gitattributes<EFBFBD>曉<EFBFBD><EFBFBD>批<EFBFBD><EFBFBD>Ｚ<EFBFBD>蝚?

2. PHP<48>滨蔭<E6BBA8><E894AD>辣<EFBFBD><E8BEA3>雿喳<E99BBF>頝?

<?php
// <20>滨蔭隞<E894AD><E99A9E>...

// <20>?<3F>躰秤嚗𡁏<E59A97>蝏𤘪<E89D8F><F0A498AA><EFBFBD>倌<EFBFBD>𣬚征銵?
?>

<?php
// <20>滨蔭隞<E894AD><E99A9E>...

// <20>?甇<>＆嚗𡁏瓷<F0A1818F>厩<EFBFBD><E58EA9><EFBFBD><EFBFBD>蝑?

3. REDCap<61>函蔡璉<E894A1><E79289>交<EFBFBD><E4BAA4>?

• Apache DocumentRoot銝𦻓ase URL銝<4C><E98A9D>?
• 蝳<EFBFBD>鍂<EFBFBD>讠憬璅∪<EFBFBD>嚗<EFBFBD><EFBFBD><EFBFBD>𤑳㴓憓<EFBFBD><EFBFBD>
• database.php<EFBFBD>怠偏<EFBFBD>鮏?>`
• <EFBFBD><EFBFBD>辣<EFBFBD>Ｚ<EFBFBD>蝚衣<EFBFBD>銝<EFBFBD>銝摔F
• 撖<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>甇<EFBFBD>＆<EFBFBD><EFBFBD><EFBFBD>
• Session<EFBFBD>桀<EFBFBD><EFBFBD><EFBFBD><EFBFBD>甇<EFBFBD>＆

---

<EFBFBD><EFBFBD> <20>𡒊賒<F0A1928A>函蔡<E587BD>啁<EFBFBD>鈭抒㴓憓?

*<EFBFBD>砍𧑐Docker撘<EFBFBD><EFBFBD>𤑳㴓憓<EFBFBD>歇撉諹<EFBFBD><EFBFBD>朞<EFBFBD>嚗<EFBFBD>虾隞亙<EFBFBD><EFBFBD>刻<EFBFBD>蝘餃<EFBFBD><EFBFBD>輸<EFBFBD>鈭䫿CS嚗?

1. <EFBFBD>?雿輻鍂<E8BCBB>詨<EFBFBD><E8A9A8><EFBFBD>Dockerfile.redcap`<60><>遣<EFBFBD>𨅯<EFBFBD>
2. <EFBFBD>?靽格㺿database.php餈墧𦻖<EFBFBD>訌DS
3. <EFBFBD>?<3F>煺漣<E785BA>臬<EFBFBD><E887AC>臭誑<E887AD>舐鍂Gzip<69>讠憬嚗<E686AC>蝙<EFBFBD>沐ginx<6E>滚<EFBFBD>隞<EFBFBD><E99A9E>嚗?
4. <EFBFBD>?<3F><><EFBFBD>厰<EFBFBD>蝵格<E89DB5>隞嗅歇蝏讛<E89D8F>撉諹<E69289>嚗䔶<E59A97>隡𡁏<E99AA1>CRLF<4C>桅<EFBFBD>

<EFBFBD>芣䔉銝漤<EFBFBD>閬<EFBFBD><EFBFBD>𣂷葵<EFBFBD>埝䰻REDCap<EFBFBD><EFBFBD>辣嚗<EFBFBD><EFBFBD>銝箏<EFBFBD><EFBFBD>嫣誨<EFBFBD><EFBFBD>糓閫<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> <20>?

---

<EFBFBD><EFBFBD> <20>𠉛頂<F0A0899B>孵<EFBFBD>

憒<EFBFBD><EFBFBD><EFBFBD>桅<EFBFBD>嚗諹窈<EFBFBD>亦<EFBFBD>嚗?

• REDCap摰䀹䲮<EFBFBD><EFBFBD>﹝嚗冴ttps://projectredcap.org/
• <EFBFBD>函蔡<EFBFBD>寞<EFBFBD><EFBFBD><EFBFBD>﹝嚗䫤docs/03-REDCap<61>砍𧑐Docker撘<72><E69298>𤑳㴓憓<E3B493><E68693>蝵脫䲮獢?md`