Gallery: 疑难解答：修订间差异

来自站长百科
跳转至： 导航、​ 搜索
无编辑摘要
第1行： 第1行：
= Troubleshooting Gallery 2 =
= Gallery2疑难解答 =
More links on troubleshooting Gallery 2: [[:Category:Gallery 2:Troubleshooting]]
Gallery2疑难解答的更多链接：[[:Category:Gallery 2:Troubleshooting]]


== Do this first ==
== 需要预先做好的工作 ==
# Clear your Gallery caches! - See [[Gallery:FAQ#How_can_I_clear_cached_data.3F|FAQ: How can I clear cached data?]]
# 清除Gallery缓存！-参见[[Gallery:FAQ#如何清除缓存数据？|如何清除缓存数据？]]
# Ensure the Gallery application files are intact! - [[Gallery:FAQ#How_can_I_make_sure_that_my_installation_files_are_all_intact.3F|FAQ: How can I make sure that my installation files are all intact?]]
# 确保Gallery应用程序文件完好无损！-[[Gallery:FAQ#如何确保安装文件完整无损？|常见问题：如何确保安装文件完整无损？]]
# Clear your web-browser caches (cookies, page cache)!
# 清除web浏览器缓存（cookies及页面缓存）！
# Enable 'buffered' debug mode to ensure that no important warnings or details are hidden
# 启用'buffered'debug模式以确保没有遗漏任何重要警告或详细信息


'''Important Note: ''' If you are not logged in as administrator, you need to enable 'buffered' '''debug mode''' to see the error name and the details. See: [[Gallery:FAQ#How_to_set.2Fuse_Gallery_in_debug_mode.3F|FAQ: How to enable Gallery's debug mode?]]. If 'buffered' debug mode does not show anything, you can try the 'immediate' or 'logged' debug mode.
'''重要提示：''' 如果你没有以管理员身份登录的话，你需要启用'buffered''''debug模式'''来检查错误名称及详细信息。参见：[[Gallery:FAQ#如何设置/使用Gallery的debug模式？|常见问题：如何设置/使用Gallery的debug模式？]]。如果'buffered' debug模式没有任何显示的话，你可以尝试'immediate'或'logged' debug模式。


== Troubleshooting by... ==
== 解决手段... ==
You can either try to find your specific issue by looking for a specific 'error name' or by locating your issue in the categorized symptoms.
你可以查找相应特定的'错误名称'来确定遇到的问题，或者在经过分类的症状中对号入座。


=== Error Name ===
=== 错误名称（Error Name） ===
Do you get the error just when browsing to the frontpage of your Gallery? If the error only occurs when browsing to a specific page / album or when attempting a special action, you should first try to 'troubleshoot by symptom / attempted action' (see below).
是不是在访问Gallery首页时就发生了错误？如果错误仅当浏览特定页面/相册时发生或尝试进行某特殊动作时发生的话，你应当先通过错误症状/尝试进行的动作的分类来尝试解决问题（见下表）。


{|class="gallery" style="background-color: #eee; width:90%"
{|class="gallery" style="background-color: #eee; width:90%"
!Error Name!!Solution
!错误名称!!解决办法
|-
|-
|ERROR_PLATFORM_FAILURE
|ERROR_PLATFORM_FAILURE
|[[Gallery:FAQ#How_can_I_fix_the_filesystem_permissions_of_the_Gallery_storage_folder.3F|FAQ: How can I fix the filesystem permissions of the Gallery storage folder?]]
|[[Gallery:FAQ#如何修复Gallery存储文件夹文件系统权限问题？|常见问题：如何修复Gallery存储文件夹文件系统权限问题？]]
|-
|-
|ERROR_OBSOLETE_DATA
|ERROR_OBSOLETE_DATA
|[[Gallery:FAQ#How_can_I_clear_cached_data.3F|FAQ: How can I clear cached data?]]
|[[Gallery:FAQ#如何清除缓存数据？|常见问题：如何清除缓存数据？]]
|-
|-
|ERROR_REQUEST_FORGED
|ERROR_REQUEST_FORGED
|
|
* Logout or clear your browser cookies and then try again.
* 登出或清除浏览器cookies并重试。
* If your Gallery is integrated in a blog, portal, forum, ... ensure that you got the latest version of the integration.
* 如果你的Gallery被整合在了一个blog，门户或论坛等之中的话，请确保是使用的整合是最新版本的。
|-
|-
|ERROR_STORAGE_FAILURE
|ERROR_STORAGE_FAILURE
|
|
* Usually either a database table got corrupted or the database connection does not work anymore.
* 一般情况是，某数据库表格崩溃或数据库连接无法运作。
* Enable 'buffered' debug mode to see the details, refresh the page and then search for 'error' in the page contents.
* 启用'buffered' debug模式来检查详细信息，刷新页面并在页面内容中搜索'error'。
* If a specific table got corrupted, you can try to repair it in phpmyadmin or with 'mysqlchk' / 'misamchk' in the command line if you have shell access to the server.
* 如果某特定表格崩溃了，而你具有服务器shell访问权限的话，就可以尝试在phpmyadmin中或使用命令行中的'mysqlchk'/'misamchk'来进行修复。
* Maybe your webhost limits how many database queries can be done per hour. See [[Gallery:FAQ#I_seem_to_be_running_into_some_sort_of_MySQL_query_limit.2C_is_there_anything_that_can_be_done.3F|FAQ: I seem to be running into some sort of MySQL query limit, is there anything that can be done?]]
* 或许你的webhost限制了单位小时内数据库查询可执行数。参见[[Gallery:FAQ#我可能碰上了某种MySQL查询限制，该怎么办呢？|常见问题：我可能碰上了某种MySQL查询限制，该怎么办呢？]]
* [[Gallery:FAQ#I_get_the_error_.27Illegal_mix_of_collations.27.2C_what_should_I_do.3F|FAQ: I get the error 'Illegal mix of collations', what should I do?]]
* [[Gallery:FAQ#发生了'Illegal mix of collations'这样的错误，该怎么办？|常见问题：发生了'Illegal mix of collations'这样的错误，该怎么办？]]
* [[Gallery:FAQ#Why_do_I_get_a_MySQL_.22Can.27t_connect_to_local_MySQL_server_through_socket.22_error.3F|FAQ: Why do i get a MySQL 'Can't connect to local MySQL server through socket' error?]]
* [[Gallery:FAQ#为何得到这样一个MySQL的错误："无法通过socket接口连接MySQL本地服务器"？|常见问题：为何得到这样一个MySQL的错误："无法通过socket接口连接MySQL本地服务器"？]]
|-
|-
|ERROR_BAD_PARAMETER
|ERROR_BAD_PARAMETER
|Did you customize / edit any template (.tpl) files or are you using a 3rd party theme or module? Try to rule out the possibility of being broken by this non-official code by removing it (in case of themes / modules: deactivate them, don't just remove them from the modules/, themes/ folder).
|是否自定义/编辑任何模板（.tpl）文件了？或者你是否在使用某第三方外观主题或模块？请尽量避免这种非官方代码所造成的破坏，你可以移除它们（拿外观主题/模块做个例子，只讲它们从modules/和themes/ 文件夹中移除是不够的）。
|-
|-
|ERROR_LOCK_TIMEOUT
|ERROR_LOCK_TIMEOUT
|See [[Gallery:FAQ#I_suddenly_got_an_.22ERROR_LOCK_TIMEOUT.22_message.2C_what_do_I_do.3F|FAQ: I suddenly get an ERROR_LOCK_TIMEOUT message, what can I do?]]
|参见[[Gallery:FAQ#我突然得到了此错误消息"ERROR_LOCK_TIMEOUT"，我该怎么办？|常见问题：我突然得到了此错误消息"ERROR_LOCK_TIMEOUT"，我该怎么办？]]
|-
|-
|ERROR_MISSING_ITEM
|ERROR_MISSING_ITEM
|
|
* If you can still access your 'Site Admin' section, you should consider running the 'integrity check' of the 3rd party module 'integrity'. It's available via 'Site admin' -> 'Plugins' since Gallery 2.2. See [[Gallery:Installing_Additional_Components|Installing Additional Components]].
* 如果你尚可访问'站点管理（Site Admin）'部分的话，你应当考虑运行第三方模块，'完整性（integrity）'模块的'完整性检查'。对于G2.2之后的版本来说，它可以在'站点管理（Site admin）' -> '插件（Plugins）'中找到。参见：[[Gallery:Installing_Additional_Components|额外组件的安装]]。
* TODO: Add link to instructions on how to manually fix such issues.
* 需要做的：为手动修复此类问题的相关指导添加链接。
|}
|}


=== Symptom / Attempted Action ===
=== 错误症状（Symptom）/尝试性动作（Attempted Action） ===
Please try to locate your issue in the below categorization. And don't forget that the [[Gallery:FAQ#How_to_set.2Fuse_Gallery_in_debug_mode.3F|debug mode]] can show a lot more information about a problem than you'd see without.
请在下面的分类中定位你碰到的问题。请记住，[[Gallery:FAQ#如何设置/使用Gallery的debug模式？|debug模式]]启用后可以显示更多该问题的相关信息，这与不使用debug模式具有天壤之别。


==== Installation ====
==== 安装 ====
{|class="gallery" style="background-color: #eee; width:90%"
{|class="gallery" style="background-color: #eee; width:90%"
!Symptom / Attempted Action!!Solution
!错误症状/尝试性动作!!解决办法
|-
|-
|Can't authenticate (Step 2) / login.txt
|无法通过验证（第二步）/login.txt
|See [[Gallery:FAQ#The_installer_does_not_accept_my_login.txt.2C_what.27s_wrong.3F|FAQ: The installer does not accept my login.txt file. What's wrong?]]
|参见[[Gallery:FAQ#为什么安装程序不接受我的login.txt？|常见问题：为什么安装程序不接受我的login.txt？]]
|-
|-
|System Checks report a problem with the 'file integrity'
|系统检查（System Checks）报告了有关'文件完整性'的问题
|See [[Gallery:FAQ#What_about_the_warning_for_missing_.26_modified_files_in_the_installer_.26_upgrader.3F|FAQ: What about the warning for missing / modified files in the installer?]]
|参见[[Gallery:FAQ#在安装程序和升级程序中出现的有关文件丢失和被篡改的警告是怎么回事？|常见问题：在安装程序和升级程序中出现的有关文件丢失和被篡改的警告是怎么回事？]]
|-
|-
|Storage Setup (Step 4) - Error creating the directory structure
|存储的安装（Storage Setup）（第四步）-创建目录结构错误
|
|
* Mostly this can happen with Windows / IIS servers. See [[Gallery:Installation_on_Windows_Server_2003_and_IIS6|Installation in Windows Server]]
* 此错误多发生于Windows/IIS服务器。参见[[Gallery:Installation_on_Windows_Server_2003_and_IIS6|Windows Server中的安装]]
* In case it happens on a linux / unix server and you confirmed via FTP program that the permissions of the g2data folder are world-writeable (777), please talk to your webhost to find out why a PHP script wouldn't be allowed to create a folder structure in g2data/.
* 如果发生在linux / unix服务器上并且通过FTP客户端确定g2data文件夹的权限为world-writeable（777）的话，请要求你的webhost来查明为何在g2data/中不允许PHP脚本进行文件夹结构的创建。
|-
|-
|Storage Setup (Step 4) - Page blank / timing out when trying to submit
|存储的安装（Storage Setup）（第四步）-页面空白/尝试提交时超时
|In case you're using G2.1.2, try G2.2. And you should check the [[Gallery:FAQ#What_is_the_webserver_error_log.3F|error log of the webserver]].
|如果你在使用G2.1.2的话，请尝试使用G2.2版本。你也该看看[[Gallery:FAQ#web服务器错误日志（error log）是什么？|有关web服务器错误日志的相关信息]]。
|-
|-
|Losing Session / Falling back to authentication step
|失去对话（Losing Session）/回退到验证步骤
|In case you're using G2.1.2, try G2.2. (related cookieless issue in 2.1). Also you should check the session settings of PHP. You can look at the PHP settings with a PHPInfo page, which is explained in: [[Gallery:FAQ#What_information_is_required_when_I_ask_for_help_in_the_forums.3F|FAQ: What information is required when I ask for help in the forums?]]
|如果你在使用G2.1.2的话，请尝试使用G2.2版本（由于2.1版本中相关的cookieless问题）。你也应检查一下PHP的对话设定。你可以通过PHPInfo页面来查看PHP设定，这在此常见问题条目中有解释：[[Gallery:FAQ#在论坛寻求帮助时哪些信息是必要的？|常见问题：在论坛寻求帮助时哪些信息是必要的？]]
|-
|-
|Database Setup (Step 5) - Missing / Incorrect database connection information
|数据库安装（Database Setup）（第五步）-丢失的/错误的数据库连接信息
|
|
* The information to connect to your database is different for every host. Please ask your webhost for the correct database connection information.
* 数据库连接信息对每个host来说都是不同的。请询问你的webhost以获取正确的数据库连接信息。
* Usually, this information can also be found somewhere in your administration panel of your website (not part of Gallery).
* 此信息一般在网站的管理面板中可以找到（非Gallery的一部分）。
* Many webhosts add a prefix (e.g. your account name) to the database name and the database user name.
* 许多webhosts在数据库名称和数据库用户名称前添加了一个前缀（如你的帐户名称）。
* Don't bother changing the 'column prefix' and the 'table prefix' if you don't understand what they're for.
* 如果不了解'column prefix'和'table prefix'的话，请不要妄加修改。
|-
|-
|Database Setup (Step 5) - Client does not support authentication protocol
|数据库安装（Database Setup）（第五步）-客户端不支持验证协议
| See [[Gallery:FAQ#Why_can.27t_I_install_with_MySQL_4.1_or_higher.3F|FAQ: Why can't I install with MySQL 4.1 or higher?]] and [[Gallery:FAQ#MySQL_.22Client_does_not_support_authentication_protocol.22_error|FAQ: MySQL Client does not support authentication protocol error]]
| 参见[[Gallery:FAQ#为何使用MySQL 4.1或更高版本却不能进行安装？|常见问题：为何使用MySQL 4.1或更高版本却不能进行安装？]]以及[[Gallery:FAQ#MySQL错误："客户端不支持验证协议（Client does not support authentication protocol）"|常见问题：MySQL错误："客户端不支持验证协议（Client does not support authentication protocol）"]]
|-
|-
|Database Setup (Step 5) - Other connection problems
|数据库安装（Database Setup）（第五步）-其他的连接问题
|
|
* These are usually DB specific issues not related to Gallery specifically. You need to ensure that PHP can communicate with the database. Searching for the error message with Google is usually a good starting point.
* 这些通常是与Gallery无明显关系的数据库问题。你需要保证PHP能够与数据库进行沟通。使用Google来查找有关错误消息的信息是个不错的开端。
* One specific is: [[Gallery:FAQ#Why_do_I_get_a_MySQL_.22Can.27t_connect_to_local_MySQL_server_through_socket.22_error.3F|FAQ: Why do i get a MySQL 'Can't connect to local MySQL server through socket' error?]]
* 某特殊情况是：[[Gallery:FAQ#为何得到这样一个MySQL的错误："无法通过socket接口连接MySQL本地服务器"？|常见问题：为何得到这样一个MySQL的错误："无法通过socket接口连接MySQL本地服务器"？]]
|-
|-
|Database Setup (Step 5) - Non-Default Port
|数据库安装（Database Setup）（第五步）-非默认端口（Non-Default Port）
|If you need to use a non-default port, just append :xxxx to the Host Name, e.g. 'localhost:3307' for port 3307 on localhost.
|如果你需要使用一个非默认端口的话，请将:xxxx后置到主机名（Host Name）之后，如本地主机3307端口就是'localhost:3307'。
|-
|-
|Install Core Module (step 8) fails
|安装核心模块（Install Core Module）（第八步）失败
|
|
* See [[Gallery:FAQ#I_get_an_error_in_the_installation_step_8_.28installing_core_module.29._What.27s_wrong.3F|FAQ: I get an error in the installation step 8. What's wrong?]] (since Gallery 2.2, we warn you about this issue in the System Checks step already)
* 参见[[Gallery:FAQ#我在安装的第八个步骤（核心模块的安装）时，遇到了错误。怎么回事？|常见问题：我在安装的第八个步骤（核心模块的安装）时，遇到了错误。怎么回事？]]（对于Gallery 2.2以来的版本，我们在系统检查步骤中以对此问题作出了警告）
* Ensure that the PHP memory_limit is 16 MB or more. 8 MB is often not enough.
* 保证PHP memory_limit为16 MB或更高。8 MB往往不是很够。
* Refreshing the page / doing the step again does not help.
* 刷新页面或重新进行该步骤是没用的。
* Sometimes, the problem goes away by running the installer again.
* 有时重新运行安装程序可以解决问题。
* To retry, you need to delete the storage folder, drop the database and start the installer from step 4 (or earlier) again, redoing these steps. Note: To save you some time, you can just click on the "Database Setup" step link on the left, click "save" and then click "erase". That way you don't have to manually delete the storage folder and the database.
* 要重试的话，你需要删除存储文件夹，清除数据库并从第四步（或前面的步骤）中重启安装程序，再重复这些步骤。注：为了能够节省些时间，你可以点击左侧的"数据库安装（Database Setup）"步骤的链接，点击"保存（save）"，再点击"清除（erase）"。这样你就不用手动删除存储文件夹和数据库了。
|}
|}


==== Upgrade ====
==== 升级 ====
{|class="gallery" style="background-color: #eee; width:90%"
{|class="gallery" style="background-color: #eee; width:90%"
!Symptom / Attempted Action!!Solution
!错误症状/尝试性动作!!解决办法
|-
|-
|Can't authenticate (Step 2) / login.txt
|无法通过验证（第二步）/login.txt
|See [[Gallery:FAQ#The_installer_does_not_accept_my_login.txt.2C_what.27s_wrong.3F|FAQ: The installer does not accept my login.txt file. What's wrong?]] (applies to the upgrade wizard as well)
|参见[[Gallery:FAQ#为什么安装程序不接受我的login.txt？|常见问题：为什么安装程序不接受我的login.txt？]]（同样适用于升级向导）
|-
|-
|System Checks report a problem with the 'file integrity'
|系统检查（System Checks）报告了有关'文件完整性'的问题
|See [[Gallery:FAQ#What_about_the_warning_for_missing_.26_modified_files_in_the_installer_.26_upgrader.3F|FAQ: WHat about the warning for missing / modified / obsolete files in the upgrader?]]
|参见[[Gallery:FAQ#在安装程序和升级程序中出现的有关文件丢失和被篡改的警告是怎么回事？|常见问题：在安装程序和升级程序中出现的有关文件丢失和被篡改的警告是怎么回事？]]
|-
|-
|System Checks report a problem with 'Storage Directory Permissions'
|系统检查（System Checks）报告有关'存储目录权限（Storage Directory Permissions）'的问题
|See [[Gallery:FAQ#How_can_I_fix_the_problem_with_the_Storage_Directory_Permissions_reported_by_the_Upgrade_Wizard.3F|FAQ: How can I fix the problem with the storage directory permissions reported by the upgrade wizard?]]
|参见[[Gallery:FAQ#如何修复升级向导所报告的Gallery存储文件夹文件系统权限问题？|常见问题：如何修复升级向导所报告的Gallery存储文件夹文件系统权限问题？]]
|-
|-
|Upgrade Core Module Step fails with error
|核心模块升级步骤由于出错而失败
|Do you see 'Illegal mix of collations' in the debug output? See [[Gallery:Known_Issues:MySQL_UTF8_Upgrade|MySQL UTF8 Upgrade]]
|是否在debug输出中看到'Illegal mix of collations'？参见[[Gallery:Known_Issues:MySQL_UTF8_Upgrade|MySQL UTF8 Upgrade]]
|-
|-
|Upgrade Other Modules Step reports missing plugins
|其他模块升级步骤报告有插件丢失
|
|
* You risk that your Gallery does not work correctly anymore if you upgrade without those modules. You should try to [[Downloads|get the latest version of these plugins]] and to put them into your Gallery modules/, themes/ folders before continuing to the next step of the upgrade wizard.
* 如果升级时没有包含这些模块的话，你的Gallery就有可能无法正常运行的风险。你应当尝试[[Downloads|获取最新版本的这些插件]]，并在继续升级程序中的下一步之前将它们置入你的Gallery modules/和themes/ 文件夹中。
* Also see [[Gallery:FAQ#I_get_a_warning_for_missing_themes_.2F_modules_in_the_upgrader.2C_what_should_I_do.3F|FAQ: I get a warning for missing themes / modules in the upgrader. What should I do?]]
* 另见[[Gallery:FAQ#在安装程序和升级程序中出现的有关文件丢失和被篡改的警告是怎么回事？|常见问题：在安装程序和升级程序中出现的有关文件丢失和被篡改的警告是怎么回事？]]
|-
|-
|Some things don't work anymore after upgrading
|在升级结束后，某些东西将不复运行
|Maybe a plugin is missing or not active. Consolut ''Site Admin'' -> ''Plugins'' (G2.2, previous versions had ''Modules'') and ensure everything is the way you want it to be.
|可能某插件丢失或不处于激活状态。查看一下''站点管理（Site Admin）'' -> ''插件（Plugins）''（G2.2版本，之前版本是''模块（Modules）'')并确保它们各司其职。
|}
|}


==== Images ====
==== 图片 ====
{|class="gallery" style="background-color: #eee; width:90%"
{|class="gallery" style="background-color: #eee; width:90%"
!Symptom / Attempted Action!!Solution
!错误症状/尝试性动作!!解决办法
|-
|-
|Thumbnails / Resized Images don't get generated correctly
|无法正常生成缩略图或重设尺寸的图片
|See [[Gallery:FAQ#Thumbnails_.2F_resized_images_don.27t_get_generated_properly.2C_how_can_it_be_fixed.3F|FAQ: Thumbnails / resized images don't get generated properly. How can it be fixed?]]
|参见[[Gallery:FAQ#缩略图/重设尺寸的图片无法正常生成，如何修复？|常见问题：缩略图/重设尺寸的图片无法正常生成，如何修复？]]
|-
|-
|No images are shown at all
|不显示任何图片
|
|
* Not even original (fullsize) images?
* 连原始（全尺寸）图片都不显示了吗？
** See [[Gallery:FAQ#Images_don.27t_show_up_and_the_album_.2F_photo_links_don.27t_work.2C_what_can_I_do.3F|FAQ: Images don't show up and the album photo links don't work either. What can I do?]]
** 参见[[Gallery:FAQ#图片无法显示，相册/相片的链接无效，我该怎么办？|常见问题：图片无法显示，相册/相片的链接无效，我该怎么办？]]
** Maybe your webhost is corrupting the image transfers. Does your webhost automatically add ads / commercials to all pages of your website? If so, this is the likely reason. Ask your webhost if you can manually add the ads somewhere on the page and then disable the automatically added ads because they break Gallery 2.
** 也许你的webhost令图片传输崩溃了。你的webhost是否在你的网站所有页面中自动添加广告或商业信息？如果是的话，这很可能就是导致出问题的原因。询问你的webhost看看能否让你自己手动添加广告并禁用自动广告添加，因为这会令你的Gallery2崩溃。
* If original images show up correctly but thumbnails and resizes do not, please see [[Gallery:FAQ#Thumbnails_.2F_resized_images_don.27t_get_generated_properly.2C_how_can_it_be_fixed.3F|FAQ: Thumbnails / resized images don't get generated properly. How can it be fixed?]]
* 如果原始图片能正常显示，但是缩略图和重设尺寸的图片不可以的话，请参看[[Gallery:FAQ#缩略图/重设尺寸的图片无法正常生成，如何修复？|常见问题：缩略图/重设尺寸的图片无法正常生成，如何修复？]]
|-
|-
|Errors when trying to build thumbnails / resized images
|当尝试进行缩略图或重设尺寸图片创建时发生错误
|Uninstall and then reinstall image toolkits. Details: [[Gallery:FAQ#Thumbnails_.2F_resized_images_don.27t_get_generated_properly.2C_how_can_it_be_fixed.3F|FAQ: Thumbnails / resized images don't get generated properly. How can it be fixed?]]
|先将图片工具包卸载再重新进行安装。详细信息见于：[[Gallery:FAQ#缩略图/重设尺寸的图片无法正常生成，如何修复？|常见问题：缩略图/重设尺寸的图片无法正常生成，如何修复？]]
|-
|-
|Thumbnails are (not) square instead of preserving the normal aspect ratio
|缩略图（不）呈方（矩）形而不按正常的长宽比显示
|Gallery generates square thumbnails if the 'square thumbs' module is active. Deactivate this module in 'Site Admin' -> 'Plugins' ('Modules' until G2.2) to change this. To change existing thumbnails, you need to rebuild them. Go to 'Edit Album' -> 'Album' to rebuid existing thumbnails according to the new settings.
|当'square thumbs'模块处于激活状态时，Gallery就会生成方（矩）形缩略图。Deactivate this module in 在'站点管理（Site Admin）' -> '插件（Plugins）'中禁用此模块（G2.2版本以前为'模块（Modules）'）可改变这种状况。若要修改已有的缩略图，你需要对它们进行重建。打开'编辑相册（Edit Album）' -> '相册（Album）'并按照新的设定重建缩略图。
|-
|-
|Error when trying to view images
|尝试查看图片时发生错误
|What kind of error? See the below section about 'troubleshooting by error name'.
|是何种错误？参见以下有关'按错误名称解决问题'部分。
|-
|-
|Images load very slowly
|图片的读取速度太慢
|
|
* Apache mod_deflate / gzip not deactivated for binary files?
* Apache的mod_deflate/gzip没有对二进制文件禁用？
* Is the Server CPU, file I/O or bandwidth limited? See: [[Gallery:Performance_Tips|Performance Tips]]
* 服务器CPU，文件I/O或是带宽限制？参见[[Gallery:Performance_Tips|性能调校技巧]]
|-
|-
|Larger images are distored / corrupted
|较大尺寸的图片变形/崩溃
|
|
* Very rare issue. No details yet. We suspect webserver configuration issues / webserver bugs.
* 此问题较罕见。尚无相关的详细信息。我们怀疑是web服务器配置问题或web服务器的bug所致。
* Check via FTP whether the files in g2data/albums/ are correct. Helps to find out whether the files on the server are corrupted or if they get corrupted during the transfer to the browser.
* 使用FTP检查g2data/albums/下的文件是否正确。这能帮助你探明是服务器上的文件崩溃还是在向浏览器的传输过程中崩溃的。
|}
|}


==== Videos / Flash ====
==== 视频/Flash ====
{|class="gallery" style="background-color: #eee; width:90%"
{|class="gallery" style="background-color: #eee; width:90%"
!Symptom / Attempted Action!!Solution
!错误症状/尝试性动作!!解决办法
|-
|-
|Download link instead of movie player
|显示的是下载链接而不是期望的电影播放器
|
|
* Did you set the dimensions of the video in 'Edit movie' -> 'Movie'? Gallery only shows an embedded movie player if the dimensions are set (to a value greater than 0). You can play the movie on your computer to find out its dimensions (movie players like VLC or Windows Media Player show the dimesions in the movie properties.
* 是否在'编辑电影（Edit movie）' -> '电影（Movie）'中对视频尺寸进行了设定？Gallery仅显示设定过尺寸（值大于0）的嵌入电影播放器。你可以先在计算机上播放此电影来查看其尺寸（类似VLC或Windows媒体播放器的电影播放器来说，尺寸的相关信息可在电影属性中找到）。
* Note: If the [[Gallery:Modules:ffmpeg|ffmpeg module]] is active, Gallery will detect and set the dimensions for all movies automatically (unless your ffmpeg binary can't handle a specific movie type).
* 注：如果[[Gallery:Modules:ffmpeg|ffmpeg模块]]处于激活状态的话，Gallery将会自动检查并为所有的电影设置尺寸（除非你的ffmpeg二进制无法处理某特定的电影格式）。
|-
|-
|No thumbnail for videos
|视频无缩略图
|
|
* Is the [[Gallery:Modules:ffmpeg|ffmpeg module]] active? Gallery can only generate thumbnails for movies with this module.
* [[Gallery:Modules:ffmpeg|ffmpeg模块]]是否启用了？仅当此模块启用时，Gallery才能够为电影生成缩略图。
* Can your ffmpeg binary handle the specific movie type? In 'Site Admin' -> 'ffmpeg' you can click 'Test' to see what types of video it should handle correctly.
* 你的ffmpeg二进制能否处理特定格式的电影？在'站点管理（Site Admin）' -> 'ffmpeg'中科点击'测试（Test）'来看看何种类型的视频可以被正确地处理。
|-
|-
|Cannot locate ffmpeg binary
|无法定位ffmpeg二进制
|Please see [[Gallery:Modules:ffmpeg|ffmpeg module]] for further information.
|请参考[[Gallery:Modules:ffmpeg|ffmpeg模块]]获取更详细的信息。
|-
|-
|Movies are not playing
|电影无法播放
|See [[Gallery:FAQ#Movies_are_not_playing_in_my_Gallery.2C_why.3F|FAQ: Movies are not playing, why?]]
|参见[[Gallery:FAQ#为什么电影无法在我的Gallery中播放了？|常见问题：为什么电影无法在我的Gallery中播放了？]]
|}
|}


==== Adding Items / Albums / Upload ====
==== 添加项目/相册/上传 ====
{|class="gallery" style="background-color: #eee; width:90%"
{|class="gallery" style="background-color: #eee; width:90%"
!Symptom / Attempted Action!!Solution
!错误症状/尝试性动作!!解决办法
|-
|-
|I can't upload anything
|无法进行上传
|
|
* To diagnose this problem you should use the 'Add items' -> 'From browser' method since it shows most debug information.
* 要诊断此问题你应当使用'添加项目（Add items）' -> '自浏览器（From browser）'的方法，因为此方法能够提供最详实的debug信息。
* In case PHP uploads are disabled completely on your webserver, there is a warning about that on the 'Add items' -> 'From browser' page. Also, this page shows the upload limits.
* 若PHP上传在你的服务器上完全被禁用的话，在'添加项目（Add items）' -> '自浏览器（From browser）'页面上会有警告提示。此页面同样显示有上传限制。
* What exactly do you see when you try to upload a file? Any errors?
* 当你尝试上传一个文件时看到了什么？错误吗？
* Verify that PHP's ''upload_tmp_dir'' is configured correctly. If you consult your webserver's error log, you might see 'PHP Warning: File upload error - unable to create a temporary file in Unknown on line 0'. In that case, upload_tmp_dir is either not defined or the webserver doesn't have access to write a file in that directory. Other errors / warnings might have the same cause.
* 确保PHP的''upload_tmp_dir''配置无误。如果查看你的web服务器日志的话，可能会看到'PHP Warning: File upload error - unable to create a temporary file in Unknown on line 0'这样的错误。这种情况下，upload_tmp_dir不是没有被定义就是web服务器不具备该目录的文件写入权限。其他错误或警告可能是同样情况。
|-
|-
|I can't upload big files
|无法上传大文件
|See [[Gallery:FAQ#Why_can.27t_I_upload_big_files_.28over_a_megabyte_or_two.29.3F|FAQ: Why can't I upload big files (e.g. over a megabyte or two)?]]
|参见[[Gallery:FAQ#为何我不能上传大文件（1MB或2MB的文件）？|常见问题：为何我不能上传大文件（1MB或2MB的文件）？]]
|-
|-
|I get an ERROR_STORAGE_FAILURE after I click the upload button
|点击上传按钮后出现这样的错误ERROR_STORAGE_FAILURE
|See [[Gallery:FAQ#I_get_ERROR_STORAGE_FAILURE_when_adding_new_photos_or_creating_albums.2C_what_should_I_do.3F|FAQ: I get ERROR_STORAGE_FAILURE when adding new photos or creating albums, what should I do?]]
|参见[[Gallery:FAQ#添加新相片或创建相册时出现了ERROR_STORAGE_FAILURE的错误，我该怎么办？|常见问题：添加新相片或创建相册时出现了ERROR_STORAGE_FAILURE的错误，我该怎么办？]]
|}
|}


==== Login====
==== 登录====
See [[Gallery:FAQ#I_can.27t_login_anymore.2C_what_can_I_do_now.3F|FAQ: I can't login anymore, what can I do?]]
参见[[Gallery:FAQ#I_can.27t_login_anymore.2C_what_can_I_do_now.3F|常见问题：I can't login anymore, what can I do?]]


{|class="gallery" style="background-color: #eee; width:90%"
{|class="gallery" style="background-color: #eee; width:90%"
!Symptom / Attempted Action!!Solution
!错误症状/尝试性动作!!解决办法
|-
|-
|Login fails with error / warning  
|Login fails with error / warning  
第220行： 第220行：




==== Toolkits / Module Activation ====
==== 工具包/模块的激活 ====
{|class="gallery" style="background-color: #eee; width:90%"
{|class="gallery" style="background-color: #eee; width:90%"
!Symptom / Attempted Action!!Solution
!错误症状/尝试性动作!!解决办法
|-
|-
|There are errors when trying to test the binaries (or when saving the configuration)
|There are errors when trying to test the binaries (or when saving the configuration)
|
|
* See: [[Installing_an_Image_Processing_Library|Installing an Image processing Library]]
* 参见：[[Installing_an_Image_Processing_Library|Installing an Image processing Library]]
* Does it report that it can't find files at the given path? See the note about the 'path' in the above linked article.
* Does it report that it can't find files at the given path? 参见the note about the 'path' in the above linked article.
|-
|-
|netpbm reports 'errno 13 (permission denied)' or ' Error reading magic number' when testing binaries
|netpbm reports 'errno 13 (permission denied)' or ' Error reading magic number' when testing binaries
第233行： 第233行：
|-
|-
|Windows / IIS specific: I cannot install any binaries
|Windows / IIS specific: I cannot install any binaries
|See [[Gallery:Installation_on_Windows_Server_2003_and_IIS6#Installing_Binaries|Installing binaries on a MS Windows / IIS server]]
|参见[[Gallery:Installation_on_Windows_Server_2003_and_IIS6#Installing_Binaries|Installing binaries on a MS Windows / IIS server]]
|-
|-
|Windows specific: Warnings about 'unable to fork'
|Windows specific: Warnings about 'unable to fork'
|See [[Gallery:FAQ#I_get_lots_of_.22Warning:_exec.28.29:_Unable_to_fork_.5Bcmd_.2Fc_....5D.22_at_the_module.27s_step_in_the_installer_for_G2_.28on_the_ImageMagick_module.29_under_Windows.2FIIS._Now_what.3F|FAQ: I get lot's of 'unable to fork' warnings, what should I do?]]
|参见[[Gallery:FAQ#I_get_lots_of_.22Warning:_exec.28.29:_Unable_to_fork_.5Bcmd_.2Fc_....5D.22_at_the_module.27s_step_in_the_installer_for_G2_.28on_the_ImageMagick_module.29_under_Windows.2FIIS._Now_what.3F|常见问题：I get lot's of 'unable to fork' warnings, what should I do?]]
|}
|}


==== Themes ====
==== 外观主题 ====
{|class="gallery" style="background-color: #eee; width:90%"
{|class="gallery" style="background-color: #eee; width:90%"
!Symptom / Attempted Action!!Solution
!错误症状/尝试性动作!!解决办法
|-
|-
|Can't upload theme into themes/ folder
|Can't upload theme into themes/ folder
|See [[Gallery:FAQ#How_can_I_upload_a_theme_or_module_via_FTP_when_I_used_the_preinstaller.3F|FAQ: How can I upload a theme or module via FTP when I used the preinstaller?]]
|参见[[Gallery:FAQ#How_can_I_upload_a_theme_or_module_via_FTP_when_I_used_the_preinstaller.3F|常见问题：How can I upload a theme or module via FTP when I used the preinstaller?]]
|-
|-
|Can't edit theme settings
|Can't edit theme settings
第250行： 第250行：
* Does it work for the 'matrix' theme but not for a 3rd party theme? Then it's probably a specific problem with the 3rd party theme and you should contact its author.
* Does it work for the 'matrix' theme but not for a 3rd party theme? Then it's probably a specific problem with the 3rd party theme and you should contact its author.
* Is JavaScript enabled in your browser?
* Is JavaScript enabled in your browser?
* Does it show no theme blocks at all? Maybe your webserver is not configured properly and blocks JavaScript requests. Or it doesn't return the right content-type for JavaScript files. Please browse to {{exampleurl|/lib/javascript/BlockSelectWidget.js}} (change the URL to match your Gallery location) and if the JavaScript code of the file displays correctly in your browser (or if you can safe the file on your computer), then it's working fine. If not, it is probably a 'mod_security' problem. See: [[Gallery:Known_Issues|Known Issues -> Apache mod_security]]. Your webhost should be notified about the problem such that they can fix the webserver configuration.
* Does it show no theme blocks at all? Maybe your webserver is not configured properly and blocks JavaScript requests. Or it doesn't return the right content-type for JavaScript files. Please browse to {{exampleurl|/lib/javascript/BlockSelectWidget.js}} (change the URL to match your Gallery location) and if the JavaScript code of the file displays correctly in your browser (or if you can safe the file on your computer), then it's working fine. If not, it is probably a 'mod_security' problem. 参见：[[Gallery:Known_Issues|Known Issues -> Apache mod_security]]. Your webhost should be notified about the problem such that they can fix the webserver configuration.
|-
|-
|Nothing works anymore after changing theme
|Nothing works anymore after changing theme
|See [[Gallery:FAQ#I_have_changed_the_default_theme_and_nothing_works_anymore._How_can_I_switch_back.3F|FAQ: I have changed the default theme and nothing works anymore. How can I switch back?]]
|参见[[Gallery:FAQ#I_have_changed_the_default_theme_and_nothing_works_anymore._How_can_I_switch_back.3F|常见问题：I have changed the default theme and nothing works anymore. How can I switch back?]]
|-
|-
|Can't reach 'Site admin'
|Can't reach 'Site admin'
|See [[Gallery:FAQ#How_can_I_change_the_default_theme_when_I_can.27t_reach_site_admin.3F|FAQ: How can I change the default theme when I can't reach 'Site admin'?]]
|参见[[Gallery:FAQ#How_can_I_change_the_default_theme_when_I_can.27t_reach_site_admin.3F|常见问题：How can I change the default theme when I can't reach 'Site admin'?]]
|}
|}


==== Modules ====
==== 模块 ====
{|class="gallery" style="background-color: #eee; width:90%"
{|class="gallery" style="background-color: #eee; width:90%"
!Symptom / Attempted Action!!Solution
!错误症状/尝试性动作!!解决办法
|-
|-
|Can't upload module into modules/ folder
|Can't upload module into modules/ folder
|See [[Gallery:FAQ#How_can_I_upload_a_theme_or_module_via_FTP_when_I_used_the_preinstaller.3F|FAQ: How can I upload a theme or module via FTP when I used the preinstaller?]]
|参见[[Gallery:FAQ#How_can_I_upload_a_theme_or_module_via_FTP_when_I_used_the_preinstaller.3F|常见问题：How can I upload a theme or module via FTP when I used the preinstaller?]]
|}
|}


==== Translation / Localization ====
==== 翻译/本地化 ====
{|class="gallery" style="background-color: #eee; width:90%"
{|class="gallery" style="background-color: #eee; width:90%"
!Symptom / Attempted Action!!Solution
!错误症状/尝试性动作!!解决办法
|-
|-
|Changing language does not work
|Changing language does not work
|See [[Gallery:FAQ#I_changed_the_language_but_nothing_happens.2C_what.27s_wrong.3F|FAQ: I changed the language but nothing happens, what's wrong?]]
|参见[[Gallery:FAQ#I_changed_the_language_but_nothing_happens.2C_what.27s_wrong.3F|常见问题：I changed the language but nothing happens, what's wrong?]]
|-
|-
|"Wrong charset, cannot convert" or "Illegal character encoding" or "Illegal recode request"
|"Wrong charset, cannot convert" or "Illegal character encoding" or "Illegal recode request"
|See [[Gallery:FAQ#Where_I_should_see_dates_I_see_.22Wrong_charset.2C_cannot_convert.22_or_.22Illegal_character_encoding.22_or_.22Illegal_recode_request.22.._what_is_wrong.3F|FAQ: Where I should see dates I see "Wrong charset, cannot convert" or "Illegal character encoding" or "Illegal recode request".. what is wrong?]]
|参见[[Gallery:FAQ#Where_I_should_see_dates_I_see_.22Wrong_charset.2C_cannot_convert.22_or_.22Illegal_character_encoding.22_or_.22Illegal_recode_request.22.._what_is_wrong.3F|常见问题：Where I should see dates I see "Wrong charset, cannot convert" or "Illegal character encoding" or "Illegal recode request".. what is wrong?]]
|}
|}


==== Other ====
==== 其他 ====
{|class="gallery" style="background-color: #eee; width:90%"
{|class="gallery" style="background-color: #eee; width:90%"
!Symptom / Attempted Action!!Solution
!错误症状/尝试性动作!!解决办法
|-
|-
|Blank / Empty Page
|Blank / Empty Page
|See [[Gallery:FAQ#I_get_only_a_blank_screen_when_trying_to_view_my_Gallery.2C_what.27s_wrong.3F|FAQ: I get only a blank screen when trying to view my Gallery. What's wrong?]]
|参见[[Gallery:FAQ#I_get_only_a_blank_screen_when_trying_to_view_my_Gallery.2C_what.27s_wrong.3F|常见问题：I get only a blank screen when trying to view my Gallery. What's wrong?]]
|-
|-
|Error when editing an album / photo item
|Error when editing an album / photo item
|ERROR_OBSOLETE_DATA? -> Clearing the cache might help: [[Gallery:FAQ#How_can_I_clear_cached_data.3F|FAQ: How can I clear cached data?]]
|ERROR_OBSOLETE_DATA? -> Clearing the cache might help: [[Gallery:FAQ#How_can_I_clear_cached_data.3F|常见问题：How can I clear cached data?]]
|-
|-
|PHP memory_limit - Allowed memory size exhausted
|PHP memory_limit - Allowed memory size exhausted
|[[Gallery:FAQ#PHP_memory_limit_-_Why_do_I_get_the_error_Allowed_memory_size_of_Xxx_bytes_exhausted.3F|FAQ: Why do I get the error 'Allowed memory size of Xxx bytes exhausted?]]
|[[Gallery:FAQ#PHP_memory_limit_-_Why_do_I_get_the_error_Allowed_memory_size_of_Xxx_bytes_exhausted.3F|常见问题：Why do I get the error 'Allowed memory size of Xxx bytes exhausted?]]
|-
|-
|Performance - Page loads are slow
|Performance - Page loads are slow
|Is the Server CPU, file I/O or bandwidth limited? See: [[Gallery:Performance_Tips|Performance Tips]]
|Is the Server CPU, file I/O or bandwidth limited? 参见：[[Gallery:Performance_Tips|Performance Tips]]
|-
|-
|Nothing happens when I click on a link / thumbnail
|Nothing happens when I click on a link / thumbnail
|Probably due to a memory limit or a fatal webserver error. See: [[Gallery:FAQ#I_get_only_a_blank_screen_when_trying_to_view_my_Gallery.2C_what.27s_wrong.3F|FAQ:  get only a blank screen when trying to view my Gallery, what's wrong?]]
|Probably due to a memory limit or a fatal webserver error. 参见：[[Gallery:FAQ#I_get_only_a_blank_screen_when_trying_to_view_my_Gallery.2C_what.27s_wrong.3F|常见问题： get only a blank screen when trying to view my Gallery, what's wrong?]]
|-
|-
|'Site admin' link does not work
|'Site admin' link does not work
|
|
* Does the link point to '/admin/'? If so, then it's likely that your URL rewrite module doesn't work correctly. You should disable it. See: [[Gallery:FAQ#Images_don.27t_show_up_and_the_album_.2F_photo_links_don.27t_work.2C_what_can_I_do.3F|FAQ: Images don't show up and the album / photo links don't work, what can I do?]]
* Does the link point to '/admin/'? If so, then it's likely that your URL rewrite module doesn't work correctly. You should disable it. 参见：[[Gallery:FAQ#Images_don.27t_show_up_and_the_album_.2F_photo_links_don.27t_work.2C_what_can_I_do.3F|常见问题：Images don't show up and the album / photo links don't work, what can I do?]]
* Also check: [[Gallery:FAQ#I_get_only_a_blank_screen_when_trying_to_view_my_Gallery.2C_what.27s_wrong.3F|FAQ: About blank screens]] (the notes about memory_limit and webserver error log are helpful here too)
* Also check: [[Gallery:FAQ#I_get_only_a_blank_screen_when_trying_to_view_my_Gallery.2C_what.27s_wrong.3F|常见问题：About blank screens]] (the notes about memory_limit and webserver error log are helpful here too)
|-
|-
|'HTTP/1.1 503 Server too busy' with IIS / fastcgi (usually just for 'Site Admin')
|'HTTP/1.1 503 Server too busy' with IIS / fastcgi (usually just for 'Site Admin')
|
|
* This seems to be a bug in [http://www.caraveo.com/fastcgi/ isapi_fcgi.dll] (the initial fastcgi implementation). See the resolution of [http://bugs.php.net/bug.php?id=37448&thanks=6 PHP bug #37448].
* This seems to be a bug in [http://www.caraveo.com/fastcgi/ isapi_fcgi.dll] (the initial fastcgi implementation). 参见the resolution of [http://bugs.php.net/bug.php?id=37448&thanks=6 PHP bug #37448].
* We suggest you rather try mod_php (instead of fastcgi) or you can use [http://www.iis.net/default.aspx?tabid=2&subtabid=25&i=1207 Microsoft's IIS FastCGI component] (a more recent FastCGI implementation) or use the [http://www.apache.org/ Apache Webserver] (usually easier to install, it's our recommended platform) instead.
* We suggest you rather try mod_php (instead of fastcgi) or you can use [http://www.iis.net/default.aspx?tabid=2&subtabid=25&i=1207 Microsoft's IIS FastCGI component] (a more recent FastCGI implementation) or use the [http://www.apache.org/ Apache Webserver] (usually easier to install, it's our recommended platform) instead.
|-
|-
第314行： 第314行：
|Some Error (don't know more)
|Some Error (don't know more)
|
|
* Enable buffered debug mode to see the exact error name. See the below section about 'troubleshooting by error name'.
* Enable buffered debug mode to see the exact error name. 参见the below section about 'troubleshooting by error name'.
* Does the error occur when browsing to your Gallery on the front page or only when you browse to a specific page?
* Does the error occur when browsing to your Gallery on the front page or only when you browse to a specific page?
|}
|}


[[Category:Gallery 2:Troubleshooting|Troubleshooting]]
[[Category:Gallery 2:Troubleshooting|Troubleshooting]]

2008年8月8日 (五) 15:22的版本

Gallery2疑难解答

Gallery2疑难解答的更多链接：Category:Gallery 2:Troubleshooting

需要预先做好的工作

  1. 清除Gallery缓存！-参见如何清除缓存数据？
  2. 确保Gallery应用程序文件完好无损！-常见问题：如何确保安装文件完整无损？
  3. 清除web浏览器缓存（cookies及页面缓存）！
  4. 启用'buffered'debug模式以确保没有遗漏任何重要警告或详细信息

重要提示： 如果你没有以管理员身份登录的话，你需要启用'buffered'debug模式来检查错误名称及详细信息。参见：常见问题：如何设置/使用Gallery的debug模式？。如果'buffered' debug模式没有任何显示的话，你可以尝试'immediate'或'logged' debug模式。

解决手段...

你可以查找相应特定的'错误名称'来确定遇到的问题，或者在经过分类的症状中对号入座。

错误名称（Error Name）

是不是在访问Gallery首页时就发生了错误？如果错误仅当浏览特定页面/相册时发生或尝试进行某特殊动作时发生的话，你应当先通过错误症状/尝试进行的动作的分类来尝试解决问题（见下表）。

错误名称 解决办法
ERROR_PLATFORM_FAILURE 常见问题：如何修复Gallery存储文件夹文件系统权限问题？
ERROR_OBSOLETE_DATA 常见问题：如何清除缓存数据？
ERROR_REQUEST_FORGED
  • 登出或清除浏览器cookies并重试。
  • 如果你的Gallery被整合在了一个blog，门户或论坛等之中的话，请确保是使用的整合是最新版本的。
ERROR_STORAGE_FAILURE
ERROR_BAD_PARAMETER 是否自定义/编辑任何模板（.tpl）文件了？或者你是否在使用某第三方外观主题或模块？请尽量避免这种非官方代码所造成的破坏，你可以移除它们（拿外观主题/模块做个例子，只讲它们从modules/和themes/ 文件夹中移除是不够的）。
ERROR_LOCK_TIMEOUT 参见常见问题：我突然得到了此错误消息"ERROR_LOCK_TIMEOUT"，我该怎么办？
ERROR_MISSING_ITEM
  • 如果你尚可访问'站点管理（Site Admin）'部分的话，你应当考虑运行第三方模块，'完整性（integrity）'模块的'完整性检查'。对于G2.2之后的版本来说，它可以在'站点管理（Site admin）' -> '插件（Plugins）'中找到。参见：额外组件的安装。
  • 需要做的：为手动修复此类问题的相关指导添加链接。

错误症状（Symptom）/尝试性动作（Attempted Action）

请在下面的分类中定位你碰到的问题。请记住，debug模式启用后可以显示更多该问题的相关信息，这与不使用debug模式具有天壤之别。

安装

错误症状/尝试性动作 解决办法
无法通过验证（第二步）/login.txt 参见常见问题：为什么安装程序不接受我的login.txt？
系统检查（System Checks）报告了有关'文件完整性'的问题 参见常见问题：在安装程序和升级程序中出现的有关文件丢失和被篡改的警告是怎么回事？
存储的安装（Storage Setup）（第四步）-创建目录结构错误
  • 此错误多发生于Windows/IIS服务器。参见Windows Server中的安装
  • 如果发生在linux / unix服务器上并且通过FTP客户端确定g2data文件夹的权限为world-writeable（777）的话，请要求你的webhost来查明为何在g2data/中不允许PHP脚本进行文件夹结构的创建。
存储的安装（Storage Setup）（第四步）-页面空白/尝试提交时超时 如果你在使用G2.1.2的话，请尝试使用G2.2版本。你也该看看有关web服务器错误日志的相关信息。
失去对话（Losing Session）/回退到验证步骤 如果你在使用G2.1.2的话，请尝试使用G2.2版本（由于2.1版本中相关的cookieless问题）。你也应检查一下PHP的对话设定。你可以通过PHPInfo页面来查看PHP设定，这在此常见问题条目中有解释：常见问题：在论坛寻求帮助时哪些信息是必要的？
数据库安装（Database Setup）（第五步）-丢失的/错误的数据库连接信息
  • 数据库连接信息对每个host来说都是不同的。请询问你的webhost以获取正确的数据库连接信息。
  • 此信息一般在网站的管理面板中可以找到（非Gallery的一部分）。
  • 许多webhosts在数据库名称和数据库用户名称前添加了一个前缀（如你的帐户名称）。
  • 如果不了解'column prefix'和'table prefix'的话，请不要妄加修改。
数据库安装（Database Setup）（第五步）-客户端不支持验证协议 参见常见问题：为何使用MySQL 4.1或更高版本却不能进行安装？以及常见问题：MySQL错误："客户端不支持验证协议（Client does not support authentication protocol）"
数据库安装（Database Setup）（第五步）-其他的连接问题
数据库安装（Database Setup）（第五步）-非默认端口（Non-Default Port） 如果你需要使用一个非默认端口的话，请将:xxxx后置到主机名（Host Name）之后，如本地主机3307端口就是'localhost:3307'。
安装核心模块（Install Core Module）（第八步）失败
  • 参见常见问题：我在安装的第八个步骤（核心模块的安装）时，遇到了错误。怎么回事？（对于Gallery 2.2以来的版本，我们在系统检查步骤中以对此问题作出了警告）
  • 保证PHP memory_limit为16 MB或更高。8 MB往往不是很够。
  • 刷新页面或重新进行该步骤是没用的。
  • 有时重新运行安装程序可以解决问题。
  • 要重试的话，你需要删除存储文件夹，清除数据库并从第四步（或前面的步骤）中重启安装程序，再重复这些步骤。注：为了能够节省些时间，你可以点击左侧的"数据库安装（Database Setup）"步骤的链接，点击"保存（save）"，再点击"清除（erase）"。这样你就不用手动删除存储文件夹和数据库了。

升级

错误症状/尝试性动作 解决办法
无法通过验证（第二步）/login.txt 参见常见问题：为什么安装程序不接受我的login.txt？（同样适用于升级向导）
系统检查（System Checks）报告了有关'文件完整性'的问题 参见常见问题：在安装程序和升级程序中出现的有关文件丢失和被篡改的警告是怎么回事？
系统检查（System Checks）报告有关'存储目录权限（Storage Directory Permissions）'的问题 参见常见问题：如何修复升级向导所报告的Gallery存储文件夹文件系统权限问题？
核心模块升级步骤由于出错而失败 是否在debug输出中看到'Illegal mix of collations'？参见MySQL UTF8 Upgrade
其他模块升级步骤报告有插件丢失
在升级结束后，某些东西将不复运行 可能某插件丢失或不处于激活状态。查看一下站点管理（Site Admin） -> 插件（Plugins）（G2.2版本，之前版本是模块（Modules）)并确保它们各司其职。

图片

错误症状/尝试性动作 解决办法
无法正常生成缩略图或重设尺寸的图片 参见常见问题：缩略图/重设尺寸的图片无法正常生成，如何修复？
不显示任何图片
当尝试进行缩略图或重设尺寸图片创建时发生错误 先将图片工具包卸载再重新进行安装。详细信息见于：常见问题：缩略图/重设尺寸的图片无法正常生成，如何修复？
缩略图（不）呈方（矩）形而不按正常的长宽比显示 当'square thumbs'模块处于激活状态时，Gallery就会生成方（矩）形缩略图。Deactivate this module in 在'站点管理（Site Admin）' -> '插件（Plugins）'中禁用此模块（G2.2版本以前为'模块（Modules）'）可改变这种状况。若要修改已有的缩略图，你需要对它们进行重建。打开'编辑相册（Edit Album）' -> '相册（Album）'并按照新的设定重建缩略图。
尝试查看图片时发生错误 是何种错误？参见以下有关'按错误名称解决问题'部分。
图片的读取速度太慢
  • Apache的mod_deflate/gzip没有对二进制文件禁用？
  • 服务器CPU，文件I/O或是带宽限制？参见性能调校技巧
较大尺寸的图片变形/崩溃
  • 此问题较罕见。尚无相关的详细信息。我们怀疑是web服务器配置问题或web服务器的bug所致。
  • 使用FTP检查g2data/albums/下的文件是否正确。这能帮助你探明是服务器上的文件崩溃还是在向浏览器的传输过程中崩溃的。

视频/Flash

错误症状/尝试性动作 解决办法
显示的是下载链接而不是期望的电影播放器
  • 是否在'编辑电影（Edit movie）' -> '电影（Movie）'中对视频尺寸进行了设定？Gallery仅显示设定过尺寸（值大于0）的嵌入电影播放器。你可以先在计算机上播放此电影来查看其尺寸（类似VLC或Windows媒体播放器的电影播放器来说，尺寸的相关信息可在电影属性中找到）。
  • 注：如果ffmpeg模块处于激活状态的话，Gallery将会自动检查并为所有的电影设置尺寸（除非你的ffmpeg二进制无法处理某特定的电影格式）。
视频无缩略图
  • ffmpeg模块是否启用了？仅当此模块启用时，Gallery才能够为电影生成缩略图。
  • 你的ffmpeg二进制能否处理特定格式的电影？在'站点管理（Site Admin）' -> 'ffmpeg'中科点击'测试（Test）'来看看何种类型的视频可以被正确地处理。
无法定位ffmpeg二进制 请参考ffmpeg模块获取更详细的信息。
电影无法播放 参见常见问题：为什么电影无法在我的Gallery中播放了？

添加项目/相册/上传

错误症状/尝试性动作 解决办法
无法进行上传
  • 要诊断此问题你应当使用'添加项目（Add items）' -> '自浏览器（From browser）'的方法，因为此方法能够提供最详实的debug信息。
  • 若PHP上传在你的服务器上完全被禁用的话，在'添加项目（Add items）' -> '自浏览器（From browser）'页面上会有警告提示。此页面同样显示有上传限制。
  • 当你尝试上传一个文件时看到了什么？错误吗？
  • 确保PHP的upload_tmp_dir配置无误。如果查看你的web服务器日志的话，可能会看到'PHP Warning: File upload error - unable to create a temporary file in Unknown on line 0'这样的错误。这种情况下，upload_tmp_dir不是没有被定义就是web服务器不具备该目录的文件写入权限。其他错误或警告可能是同样情况。
无法上传大文件 参见常见问题：为何我不能上传大文件（1MB或2MB的文件）？
点击上传按钮后出现这样的错误ERROR_STORAGE_FAILURE 参见常见问题：添加新相片或创建相册时出现了ERROR_STORAGE_FAILURE的错误，我该怎么办？

登录

参见常见问题：I can't login anymore, what can I do?

错误症状/尝试性动作 解决办法
Login fails with error / warning
  • Forgot password? (does email not work? Contact admin, admins can use login.txt instead and fix email or reset the user account)
  • Do you have any special characters in your password? Prior to Gallery 2.1 this could lead to login problems under certain circumstances. Consider upgrading your Gallery.
  • Does it say your user account is "disabled"? (since G2.2) Use the "Forgot Password" link on the login page to reactivate your account.
Login fails and just displays a normal Gallery page again
  • Often clearing the browser cookie cache helps. Check your web-browser settings and clear the cookies for your Gallery website.
  • Sometimes, you are actually logged in but still see a page that looks like you are not logged in because your browser did not update its own cache. Please check your web-browser settings and clear the browser cache.
  • Is your webserver IIS/5.0 or older and is your Gallery 2 version older than 2.0? We added a workaround for an IIS bug shortly before the official release of Gallery 2.0, you should upgrade your Gallery.


工具包/模块的激活

错误症状/尝试性动作 解决办法
There are errors when trying to test the binaries (or when saving the configuration)
netpbm reports 'errno 13 (permission denied)' or ' Error reading magic number' when testing binaries If you are sure that filesystem permissions are correct, please check Installation on a SELinux Server as well.
Windows / IIS specific: I cannot install any binaries 参见Installing binaries on a MS Windows / IIS server
Windows specific: Warnings about 'unable to fork' 参见常见问题：I get lot's of 'unable to fork' warnings, what should I do?

外观主题

错误症状/尝试性动作 解决办法
Can't upload theme into themes/ folder 参见常见问题：How can I upload a theme or module via FTP when I used the preinstaller?
Can't edit theme settings
  • Does it work for the 'matrix' theme but not for a 3rd party theme? Then it's probably a specific problem with the 3rd party theme and you should contact its author.
  • Is JavaScript enabled in your browser?
  • Does it show no theme blocks at all? Maybe your webserver is not configured properly and blocks JavaScript requests. Or it doesn't return the right content-type for JavaScript files. Please browse to http://www.example.com/gallery/lib/javascript/BlockSelectWidget.js (change the URL to match your Gallery location) and if the JavaScript code of the file displays correctly in your browser (or if you can safe the file on your computer), then it's working fine. If not, it is probably a 'mod_security' problem. 参见：Known Issues -> Apache mod_security. Your webhost should be notified about the problem such that they can fix the webserver configuration.
Nothing works anymore after changing theme 参见常见问题：I have changed the default theme and nothing works anymore. How can I switch back?
Can't reach 'Site admin' 参见常见问题：How can I change the default theme when I can't reach 'Site admin'?

模块

错误症状/尝试性动作 解决办法
Can't upload module into modules/ folder 参见常见问题：How can I upload a theme or module via FTP when I used the preinstaller?

翻译/本地化

错误症状/尝试性动作 解决办法
Changing language does not work 参见常见问题：I changed the language but nothing happens, what's wrong?
"Wrong charset, cannot convert" or "Illegal character encoding" or "Illegal recode request" 参见常见问题：Where I should see dates I see "Wrong charset, cannot convert" or "Illegal character encoding" or "Illegal recode request".. what is wrong?

其他

错误症状/尝试性动作 解决办法
Blank / Empty Page 参见常见问题：I get only a blank screen when trying to view my Gallery. What's wrong?
Error when editing an album / photo item ERROR_OBSOLETE_DATA? -> Clearing the cache might help: 常见问题：How can I clear cached data?
PHP memory_limit - Allowed memory size exhausted 常见问题：Why do I get the error 'Allowed memory size of Xxx bytes exhausted?
Performance - Page loads are slow Is the Server CPU, file I/O or bandwidth limited? 参见：Performance Tips
Nothing happens when I click on a link / thumbnail Probably due to a memory limit or a fatal webserver error. 参见：常见问题： get only a blank screen when trying to view my Gallery, what's wrong?
'Site admin' link does not work
'HTTP/1.1 503 Server too busy' with IIS / fastcgi (usually just for 'Site Admin')
No edit link / cannot edit album / item
  • In case you removed the 'Item Actions' block from your theme settings, Gallery should display a small "edit" link in most themes. You can add this link to your themes with 
    {g->block type="core.EmergencyEditItemLink" class="gbBlock"}
  • Else, verify that you're logged in with the admin user or any other user with sufficient permissions and consider clearing your browser's cache.
Some Error (don't know more)
  • Enable buffered debug mode to see the exact error name. 参见the below section about 'troubleshooting by error name'.
  • Does the error occur when browsing to your Gallery on the front page or only when you browse to a specific page?
取自“https://www.zzbaike.com/wiki/index.php?title=Gallery:疑难解答&oldid=8379”